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PREFACE 



The software product identified as Multics Forum is the property of the Massachusetts 
Institute of Technology and distributed by Honeywell Information Systems under license from 
the Massachusetts Institute of Technology. 

This book is a detailed description of the Multics Forum Interactive Meeting System. It 
is intended for all users; both those who have relatively little experience on the Multics 
operating system {or any other computer system) and experienced programmers will find this a 
complete description. You are, however, expected to be familiar with the Multics concepts 
described in the 2-voIume set, New Users' Introduction to Multics — Part I (Order No. 
CH24), and — Part II (Order No. CH25), referred to in this manual as New Users- 
Introduction. 



The sections of this manual fully describe how to attend Forum's online meetings. The 
first five sections tell you everything you need to know to attend meetings. This part of the 
manual may be all you need if you are a beginning Multics user. Section 6 describes some 
advanced concepts, including how to tailor your Forum environment to your special needs. 
Section 7 contains detailed descriptions of all the Forum requests. Section 8 is an alphabetical 
reference section of users' commands. Section 9 describes the duties of the chairman of the 
meeting. Section 10 is an alphabetical reference to the chairman's commands. Appendix A 
contains information needed by system administrators. Appendix B contains the subroutine 
descriptions. Appendix C is a glossary of Forum terms. 

Manual Conventions 

A few conventions and special symbols used in this manual should be introduced before 
you begin to explore the Multics Forum Subsystem. 

Throughout the manual, "Forum" designates the Multics Forum Subsystem and the 
all-lowercase "forum" refers to the Multics command invoked to use this system. 

Technical or other unfamiliar terms are italicized when used the first time, and are 
defined in the glossary in Appendix C 



The information and specifications in this document are subject to change without notice. This 
document contains information about Honeywell products or services that may not be available 
outside the United States. Consult your Honeywell Marketing Representative. 
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or the way a word should appear on a line typed by a user. Requests or commands that also 
have a short or abbreviated name appear in parentheses following the first occurrence of the 
name in text— for example, when introducing the "talk" (t) request You do not type these 
quotation marks or parentheses. 

A convention used within -examples is the use of an exclamation point (!) to indicate 
lines you type. The exclamation point does not appear on your terminal — you do not type it, 
and Multics does not type it to prompt you. Exclamation points appear only in examples, and 
only to show which lines you type. Remember too, that every line you type must end with a 
carriage return (RETURN). 

Text within angle brackets (<...>) is used within examples for explanatory purposes 
ONLY. It is not actually typed by Multics, and it should not be typed by you. 

Throughout this manual, references are made to the Multics Programmer's Reference 
Manual (Order No. AG91), Multics Commands and Active Functions (Order No. AG92), 
and Multics Subroutines and 110 Modules (Order No. AG93) manuals. For convenience, 
these are referred to in text as the Programmer's Reference manual, the Commands manual, 
and the Subroutines manual, respectively. 

Significant Changes in CY74-02 

A forum meeting created with pre-MRll software consists of two storage system 
segments which contain records of the participants in the meeting and what has been said. 
These meetings contain the suffixes ".control" or ".proceedings". A current version forum 
meeting (MRU or later) is created as a single segment with the suffix ".forum". The current 
version forum software supports both pre-MRll forum meetings and current version forum 
meetings. 
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The meetings created with current version forum software are treated as entries within 
the Multics storage system. Since current version forum meetings are treated as such, you can 
use the standard file system commands such as copy, delete, list_acl, and set_acL This support 
also alleviates limitations on the number of meeting attendees and transactions. Current 
version meetings have no easily relizable limit on the amount of information which they can 
contain. 

The current version forum also incorporates a new search strategy for locating forum 
meetings by looking in the forum list to find the meetings. 

Forum now allows you to use transaction specifiers with forum requests. See Section 3 
for details. 

Forum now marks each transaction with the keyword "seen" or "unseen*'. See Section 3 
for details. 

The following new requests have been added to forum: 

addjneet i ng (am) ma i 1 

announcement^ nfo (ai) next_meeting (nm) 

announce_meet i ng (anm) remove_meeting (rra) 
checkjneet i ngs (ckm) 

See Section 7 for details. 

The safety switch and the seen TRANS_SPECS switch have been added to the 
switchjoff and switch_on commands. See Section 7 for details. 

New control arguments have been added to the following requests: 



list_users Osu) 


talk (t) 


qedx (qx) 


ted 


reply (rp) 


wr 1 te (w) 


reset (rs) 





See Section 7 for details. 

Two new user commands have been added to assist you in managing the list of meetings 
that you attend. The forum_add_meeting (fam) command adds a meeting to the list of 
attended meetings. The forum_remove_meeting (frm) command removes a meeting from the 
list of attended meetings. See Section 8 for details. 

New control arguments have been added to the forum_list_users (flsu) user command. 
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YOU Can now use the standard arrass rrnil-rrVI 1ict fAn \ mmmo^/Jr fij e t «^i c. A t ««i „•*,* 

delete_acl) with forum meetings. See Section 9 for details. 

The new convert_forum command converts a forum meeting created with pre-MRll 
software to a current version forum meeting. See Section 10 for details. 

The new site meeting directory is a public meeting where you can place announcements 
about meetings of general interest See Appendix A for details. 

The entries in the forum_chairman_ gate have been moved to the forum_ gate. 

The following entries have been added to the forum_ subroutine: 

f orum_$change_cha i rman 

forum_$chname_forum 

forum_$change_chairman_idx 

f orum_$chname_f orum_i dx 

forum_$create_forum 

forum_$set_vl_forum_acl 

forum_$convert 

forum_$de]ete_forum_acl 

forum_$expunge 

f GTUfTi_$get_swi tch 

f orum_$get_u i d_f i 1 e 

forum_$ 1 i st_forum_ac] 

f orum_$rep] ace_f orum_ac 1 

f orum_$set_f orum_ac 1 

forum_$set_seen_swi tch 

The following entry has been added to the forum_admin_ subroutine. 
forum_admin_$convert 

See Appendix B for details. 
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CCr^T'TrMVT 1 

INTRODUCTION TO FORUM 



MEETINGS— WITH A DIFFERENCE 

The Multics Forum subsystem lets you engage in ongoing discussions about any topic in 
an orderly and controlled fashion. 

Forum is often described as a teleconferencing system and is sometimes described as a 
bulletin board system. Actually, it is a bit of both. Using Forum, you can create (convene) 
meetings; you can specify exactly who may participate in the meetings; and you can pose 
questions, make assertions, offer opinions, and express points of view to the other 
participants. 

The system parallels the structure and function of "real" meetings. Forum provides 
requests that allow you to enter a meeting, see who else is participating, find out what has 

been Said Since the last time vnn nttpnH*»/i th*> mw>tiri« nnA /»/v^~-.a.,+ «.- -_,, ♦ :_ i 

-—- — - j — — ubiviiuMi »a.**w wiw ».AAi£, uiiu vuiiituviii uli ally ItJUl^ lillUCX 

discussion. 

Forum, however, overcomes the restrictions of real meetings in several important ways. 
Forum's meetings can last for weeks or months and, no matter when you decide to "drop 
in," you can read every comment made since the meeting's inception. Even if you have 
nothing to say in the meeting, it's a great way to keep abreast of all developments. 

Another difference is that by using Forum, groups of people can effectively 

communicate with each other even when separated by great distance in both space and time. 

For instance, many meetings now in use involve people located in all parts of the United 
States, Canada, and much of Western Europe, 

BENEFITS AND TYPICAL USES OF FORUM 

User communities put Forum to many interesting uses. Frequently, special interest groups 
establish meetings to allow all the members of a project team to effectively communicate and 
coordinate their activities (a sort of project management tool). Some meetings are useful 
places to solicit information from a wide body of users on a given subject ("Anyone know of 
a good article on PASCAL implementations?"). Often, a real bulletin board meeting is put up, 
so that people can advertise or solicit lodgings, places to get their cars fixed, and so on! 
Some meetings are design review meetings, in which someone proposes a detailed design and 
invites comments from co-workers and others. In general, meetings can be used for any 
purpose whatsoever. 



1-1 CY74-02 



The main benefit of Forum can be summarized in one word: information. Forum 
enables the effective distribution of information from the people who have the knowledge to 
the people who need the information and overcomes the barriers imposed by space, time, and 
number of participants. It is not meant to replace electronic mail, for there is no substitute 
for a secure and flexible system for one-to-one or one-to-few communication. It is rather 
designed to establish a wider community of users, sharing their knowledge and keeping them 
well-informed on issues of interest. 

THE MEETING 

Meetings can be public meetings, which are open to everyone, or private meetings, 
which are open only to designated participants. The creation of a public or private meeting is 
an option available to the chairman when the meeting is created. Section 2 describes how to 
determine whether you are eligible to attend a meeting. Section 9 describes how a chairman 
can set up public and private meetings. 

Transactions 

Meetings consist of a series of transactions. Entering a transaction in a Forum meeting 
is equivalent to speaking in a live meeting. If you are the chairman of a meeting, you first 
convene (create) the meeting and decide who will be eligible to attend. Then you enter the 
first transaction, which states the purpose of the meeting. Eligible participants can add entries 
(transactions)--this collection of transactions makes up the meeting. Here are some sample 
transactions: 

[0001] (5 lines) Brooks. ProjA 05/18/83 0320.9 est Hon Everybody ' s_meeting 

Subject: Reason for this meeting 

This meeting is a general meeting, open to all, and open to discussion of 

any issues related to the Multics system. Issues related to the 

forum subsystem itself should be discussed in the forum_problems 

(forprob) meeting, and so-called public notices should be placed in the 

Bui letin_board (bb) meeting. 

— [0001] — 

This is a sample initial transaction for a meeting called "Everybody 's_Meeting." Forum 
numbered the transaction and supplied the other information shown in the first line. [0001] 
is its transaction number. (The chairman of a meeting always enters the first transaction in a 
meeting.) The rest of the first line describes how long the text of the transaction is (5 lines), 
who entered it (Brooks.ProjA), and the date and time it was entered (5/18/83 0320.9 est 
Mon). The user Brooks (on the ProjA project) typed in the subject and the text 

[0002] (3 lines) Davis. YAK 05/20/83 0002.3 est Wed Everybody' s_Meeting 
Subject: Fortran for a Beginner 

Does anyone have a really good, basic, simple book about Fortran and the 
basic commands? I just want to put a little variety into my repertoire 
of languages. 

— [0002] — 
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This is a sample second transaction, entered into the meeting by a user named Davis on the 
YAK project A transaction that starts discussion on a new topic is entered via Forum's 
"talk" (t) request (described in section 5). The talk request always prompts for the subject of 
your transaction. 

As a participant you understand that the initial transaction and statement of purpose 
(see [0001] above) throws the session open to discussion. From that point on, any eligible 
participant can bring up any related subject or idea. The initial transaction is numbered 
Transaction 1, and transactions are numbered sequentially by Forum as you enter them. The 
meeting remains open to discussion indefinitely since meetings are open-ended and have no 
time limit on their existence. When the chairman feels that the meeting has fulfilled its 
purpose or outlived its usefulness, he or she deletes it. 

Transaction Chains 

A reply to any transaction begins a transaction chain — a discussion concerning a 
previous transaction. Entering a transaction that refers to a previous transaction is equivalent 
to making a comment on a previous statement in a live meeting. Here is an example: 

[0006] (1 line) Perri.YAK 05/23/81 1005-9 est Wed Everybody ' sjteeti ng 

Subject: Re: Fortran for a Beginner 

Try the Fortran book by McKracken (or however you spell it!) 

— [0006] — 

User Petri wanted to make a suggestion regarding transaction [0002] (shown above) so he 
used Forum's "reply" request (described in Section 4). The reply request automatically 
generated the subject as shown here. This transaction chain now consists of transactions 
[0002] and [0006]. Transaction chains often grow quickly as other attendees interject 
opinions on the same subject 
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GETTING STARTED 



This section tells you how to enter the Forum subsystem and introduces the Forum 
request loop. You will find out where meetings are held on your system and how to attend 
them. 



ENTERING THE FORUM SUBSYSTEM 



The Request Loop 

Once you invoke Forum, everything you type is interpreted by the Forum request 
processor, not the Multics command processor. You will use Forum requests to accomplish 
your tasks. To enter the Forum subsystem, simply issue the "forum" command: 

! forum 
forum: 

This enters you into the request loop. The prompt "forum:" appears on your screen which is 
where you are to type any of the various requests in Forum's repertoire. Forum request lines 
must end with a carriage return, just like Multics commands. Forum processes a request by 
performing the desired action, and then prompts you for another request. This cycle repeats 
until you quit forum (by issuing the "quit" request described below). 

At this point, you are not attending a meeting, but there are a number of things you 
can do such as list meetings and get help. 

Listing Meetings 

The forum request "list_meetings" (or the short form, Ism) is used to print out a list of 
all the meetings that you are eligible to attend: 

forum: ! Ism 

Meetings ■ 3. Changed = 

Everybody' s_Meeting eve 
Bui letin_board bb 
Personal_computers pc 

forum: 
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This is a list showing the long and short names of meetings that you can participate in. 
Since you have not attended any meetings yet, none of them are reported as changed 
("Changed = 0"). (You can get the same information with the Muitics command 
forum_list_meetings (flsm) described in Section 8.) 

After you attend some meetings, the output also prints some flags for each meeting. 
The flags are the individual letters in the leftmost columns. They tell you what sort of rights 
you have relative to each meeting and what your state is for each meeting. The "a" flag 
means that you are currently attending that meeting. The "p" flag means that you are already 
a participant of the meeting (have previously attended the meeting). The "c" flag means that 
the meeting has changed (which means simply that other participants of that meeting have 
entered transactions since the last time you attended the meeting). The "o" flag means that 
you are eligible only to be an observer, i.e., you can read the transactions but cannot enter 
any transactions. The "n" flag means that you have the notify switch turned on, that is, that 
you have asked to receive an automatic online notification every time a transaction is entered 
in the meeting. The "r" flag means that you have removed yourself from participation in the 
meeting. The "j" flag indicates meetings which have been adjourned by the chairman. For a 
complete description of how to turn these flags on and off, see the "switch_on" and 
"switch_off" request descriptions in Section 7. 

Getting Help 

Forum offers various ways to get help at your fingertips. For a list of available Forum 
requests, type a "?". To get a brief description of the requests, type "list_requests" (lr). To 
get a detailed explanation of requests and other Forum topics, type "help TOPIC" where 
TOPIC is the name of a request or other topic. For a list of TOPICS for which help is 
available, type "list_help" (lh). These requests are explained in more detail in Section 5. 

LOCATING MEETINGS 

Before you attend a live meeting, you must first find out where it is being held. 
Meetings can be stored in the central Forum directory or meetings can be stored in a private 
directory created by any user. Directions for finding meetings are described below. 

The Central Forum Directory 

The central forum directory is the main location for meetings that have been set up for 
public exposure at each site. The forum_dir (fd) command/active function (fully described in 
Section 8) prints your site's central forum directory: 

! fd 
The central forum directory is >site>forum dir. 
r 08:31 0.171 

Thus, to attend a meeting called "fortran" in the central forum directory, you would type: 
S forum >site>forum dir>fortran 
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Meetings in Private Directories 

Meetings can be created and stored anywhere in the Multics storage system. In order 
for you to locate any of these "private" meetings, one of the participants must supply you 
with the full pathname of the meeting. Thus, if user JohnB creates a meeting called 
"new_projects" in the directory 

>udd>ProjA>JohnB>meetings, you can attend this meeting by entering the command: 

! forum >udd>ProjA >JohnB>meetings>new_projects 



Forum Search Paths 

A short-cut to typing the full pathname every time you want to attend a meeting is the 
use of the forum search paths. 

There are usually two search paths in your forum search list put there automatically 
every time you log in. One is the central forum directory, and the other is a directory 
under your home directory called "meetings" (whether it exists or not). 

Issue the print_search_paths (psp) command (fully described in the Commands manual) 
to print your forum search paths: 

! psp forum 
forum 

>udd>[user project]>[user name] >mee tings 

>si te>forum dir 
r 08:32 0.201 3 ~ 

You can attend any meetings kept in these directories by telling Forum only the meeting's 
name (not the full pathname). Forum searches these directories automatically to find it. 

To allow Forum to find meetings that do not reside in the central forum directory, but 
that you will be attending frequently, add their pathnames to the forum search list Suppose 
you want to attend meetings under JohnB's home directory. Before entering Forum, type the 
Multics command line: 

! asp forum >udd>ProjA>JohnB>meeti ngs 

to add the pathname of the directory to the forum search paths. Or, if you have already 
invoiced the Forum subsystem, issue the request 

! ..asp forum >udd>ProjA>JohnB>meetings 

to add the location of JohnB's meetings to your already-established forum search paths. Now 
whenever you want to attend the User_issues meeting in that directory, simply type "forum 
User_issues" at Multics command level, or "goto User_issues" from Forum request level. The 
"goto" request is simply the request that tells Forum what meeting you want to attend. 
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If you use one of the above methods, you must type issue the add_seareh_paths 
command every time you log in to attend JohnB's meetings. If you modify your search list 
in your start_up exec_com, it enables Forum to locate these meetings every time you login. 
See the New Users' I nt reduction- -Pari 11 manual, Order No. CH25 for a description of 
the start_up.ee. 

Adding a Meeting 

If you don't want to enter the full pathname of meetings, you can use the 
forum„add_meeting, (fam) command to add the meetings you want to attend to your forum 
search list The forum_add_meeting command creates links to the meetings in the directory 
>udd>Project>Person>meetings and makes you a participant in the meeting. To add a meeting 
to your forum search list, go to your "meetings" directory. 

! create_dir [hd]>meetings 

and add the pathnames of forum meetings to be added to the search list 
! fam >udd>ProjA>BruceM>meetings>User_issues 

Forum searches in a directory called "meetings" under your home directory by default If the 
home_directory named meetings does not exist, the add_meeting command will create a link 
to this directory. 

To attend the User_issues meetings, type "forum User_issues" (or "goto User_issues" if 
you are already in the request loop) and Forum will locate the link for the User_issues 
meeting. 

The create_dir and the home_dir active functions are fully described in the Multics 
Commands and Active Functions manual, Order No. AG92. The forum_add_meeting 
command is described later in this manual. 

ATTENDING A MEETING 

There are two ways to enter a meeting. One way is to give the meeting's name as an 
argument to the forum command when you first invoke the subsystem. For example, to enter 
the Everybody's_Meeting (short_name "eve"), type: 

I forum eve 

Everybody 's_Meeting: 9 new, 10 last. 

The meeting is public. 

forum: 
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If you are already inside Forum's request loop, use the "goto" request 

forum: ! goto eve 

Everybody 's_Meeting: 9 new, 10 last. 

The meeting is public. 

forum: 

You are now attending the meeting and have become a participant in it. The "9 new, 10 
last" message tells you that there are 9 transactions that you have not yet seen and that the 
10th transaction is the last one entered in the meeting. The first transaction, the chairman's 
initial message, is not included in the count. 

The message "The meeting is public" is an eligibility message, which is printed 
automatically when you first enter a public meeting (if the chairman of the meeting and site 
administrator have turned it on — see Section 9 for details). If the meeting is private, the 
eligibility message gives you other information instead such as, "There are 20 users and 2 
projects eligible to attend". 

Now that you are attending "Everybody's_Meeting," each request that you issue pertains 
to this meeting until you leave it and enter a different meeting with the "goto" request 

Finding Out Who Is Chairman 

To find out who is chairing the meeting, type: 

forum: ! chairman 
Brooks. Proj A 

forum: 

The "chairman" (cm) request gives you the Person_id.Project_id of the chairman of 
Every body's_Meeting. 

Listing Other Participants 

To find out who else is participating in the meeting, use the "list_users" (lsu) request 

forum: ! list_users 

Users of the >udd>ProjA>forum>Everybody ' s_Heeting meeting. 

Flags Person Last [0010] Last time attended 

JohnB.ProjA [0009] 03/22/83 1103-3 est Mon 

LeeB.ProjA *END* OV07/83 0202.3 est Wed 

forum: 
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On the header line, "Last [0010]" means that the last transaction in the meeting is number 
ten, and the list shows the transaction number of the last one read for each user. "*END*" 
means that the indicated user has read the proceedings through to the end (through the last 
transaction). 

The -eligible control argument to the "list_users" request tells who is eligible to 
participate in the meeting, rather than who currently participates. This request line tells you 
who else is explicitly able or unable to attend. 

Check the eligible users in the "eve" meeting: 

forum: ! lsu -eligible 

Eligible users of the >udd>ProjA>forum>Everybody 's_Meeting meeting. 

The meeting is public. 

The following users are not eligible to participate: 

DVader 

forum: 

The "eve" meeting in the above example is a pre-MRll, public meeting in which the 
chairman has not (with one exception) specified any users or projects as eligible or ineligible 
to participate. The following is an example of the output from the same request line issued 
in a private, current version forum meeting: 

forum: ! lsu -el igible 

Eligible users of the >1 ib>forum>forum_dir>Bul letin_board meeting. 

rw Vade . * . * 
rwc I J ah 
rw *.*.* 

forum: 

The access mode "r" allows you to read transactions, "w" allows you to enter tranactions and 
"c" gives you chairman access. In the above forum meeting, all participants can read and 
write transactions but only the participant Uah is designated as the chairman. 
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MANAGING MEETINGS 

Two commands are available to assist you in managing the list of meetings that you 
attended. The forum_add_meeting <fam) command (described in Section 8) adds a meeting to 
the list of meetings attended. The add_meeting (am) request (described in Section 7) also adds 
a meeting to the list of meetings attended. You can invoke the add_meeting request on a 
meeting pathname or on a transaction number of a meeting announcement 

The forum_remove_meeting (frm) command (described in Section 8) removes a meeting 
from the list of meetings attended. The remove meeting (rm) request (described in Section 7) 
also removes a meeting from the list of meetings attended. You can invoice the 
remove_meeting request on a meeting pathname. 

You can use the announce_meeting (anm) request (described in Section 7) to 
automatically place an announcement about a newly created meeting either into the site's 
public meeting_directory or a private meeting. For more information on the Site Meeting 
Directory, refer to Appendix A later in this manual. This announcement is in a format 
acceptable to the add_meeting request Other users can use this announcement with the 
add_meeting request to add the current meeting to their search list 

To specify where you want the announcement to be placed, use the -meeting (-mtg) 
control argument with the announce_meeting request After you have used the announce 
meeting request to place an announcement in another meeting, you can use the announcement_info 
request u> eXiX&Ci. iniOrmation irom a meeting announcement This request must refer to a 
transaction entered by announce_meeting, otherwise an error will occur. 

EXITING FORUM 

Maybe you've had enough for now and would like to get out of Forum. Simply use 
the forum "quit" (or q) request 

forum? ! q 

r 09.19 1.007 kk 

When you receive the ready message, you know you are out of Forum and back at Multics 
command level. 
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SECTION 3 
READING TRANSACTIONS 



This section describes how to peruse the proceedings of a meeting. The first part of 
this section tells you how to list transactions, i.e., how to print a list that tells you a little 
bit about each transaction that was entered in the meeting. The second part of this section 
shows you how to print transactions, i.e., how to read the contents of lie transactions that 
you're interested in. The third part of this section introduces the write request which is used 
to save transactions in a separate segment The fourth part of this section tells you about 
transaction specifiers, i.e., about the ways that you can tell Forum to list, print or write only 
certain transactions (the ones that you specify). The last part of this section tells you how to 
make sure that you stay aware of new transactions in the meetings that are of importance to 
you. 

LISTING TRANSACTIONS 

You can find out summary information about the proceedings of a meeting with the 
"list" (Is) request It gives you a brief description of each transaction including the 
transaction number, its length (how many lines it contains), the date and time it was entered, 
the author's name, and the subject of the transaction. 

Let's assume that you're still attending "Everybody's_Meeting", which you entered in 
Section 2. The "list" request used at this point lists all transactions in this meeting. To 
obtain a summary report of these transactions, type: 



forum: 


! list 










Trans# 


Li nes 


Date 


Time 


Author 


Subject 


[0001] 


(5) 


05/18/81 


03:20 


Brooks. Proj A 


Reason for this meeting 


[0002] 


(3) 


05/20/81 


03:46 


Davis. YAK 


Fortran for a Begin<More> 


[0003] 


(3) 


05/21/81 


06:i»9 


Smith.ProjB 


Other Meetings 



forum: 

If you don't want to see a list of all the transactions in the meeting, you can specify 
only those that meet a certain criteria by using transaction specifiers. The simplest case is 
specifying a transaction by its transaction number. For example, typing "list 1" will print only 
a summary line about transaction [0001]. See the section on "Transaction Specifiers" below. 
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PRINTING TRANSACTIONS 

Transaction [0001] states the reason for this meeting. To print it on your terminal, use 
the "print" (pr, p) request with the transaction specifier "1": 

forum: ! print 1 

[0001] (5 lines) Brooks. ProjA 05/18/81 0320.9 est Mon eve 

Subject: Reason for this meeting 

This meeting is a general meeting, open to all, and open to discussion 

of any issues related to the Multics system. Issues related to the 

forum subsystem itself should be discussed in the forum_problems 

(forprob) meeting, and so-called public notices should be placed in 

the Bui letin_board (bb) meeting. 

---[0001] — 

forum: 

You can find out through the list request {see above) which other transactions you want 
to print Use their transaction number to do so (e.g., "print 2"), or use a string of 
transaction numbers (e.g., "print 2 3 4"). To go through and print them one by one by use 
the "next" (n) keyword; instead of "print 2", type "print n". A keyword is another kind of 
transaction specifier (see "Transaction Specifiers" below). 

WRITING TRANSACTIONS 

If you want to save the transactions of a meeting in a separate segment for use later, 
use Forum's "write" (w) request This request writes a copy of each transaction matching your 
selection criteria (or the current transaction if you don't specify any in particular) to a 
segment created in your working directory. You can give the segment any name you want by 
using the "-pathname PATH" control argument. Forum will append the suffix ".trans" to 
PATH automatically if you don't supply it If you wish to create the segment in another 
place in the storage system (i.e., in a directory different from your current working 
directory), you can give a full pathname for PATH. See the New User's Introduction— Part I 
for a description of pathnames. If you do not give the -pathname control argument, Forum 
will create <meeting_name>.trans in your working directory, where <meeting„name> is the 
name of the current meeting. 

To write the 10th transaction in the Everybody's_Meeting to a segment named 
"save_this. trans" in your working directory, type the following: 

forum: ! write 10 -pathname save_this 

Writing 1 transaction to >udd>ProjA>Your_name>save_th is. trans. 

forum: 

If you also want to save transactions 15 through 20 in the same file, type: 

forum: ! write 15:20 -pn save_this 

Appending 6 transactions to >udd>ProjA>Your_name>save_th is. trans. 

forum: 
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As you cars see, you can specify a range of transactions in the current meeting, in this case 
"15:20" for transactions 15 through 20 inclusive. The above request line appends the 
transactions to save_this. trans, separating the transactions by appending a formfeed character 
(new page) to each. Each transaction is printed on a separate page by default, but you can 
specify different delimiters (if any) with either the -separator or -no_separator control 
arguments (see the "write" request description in Section 7). If you save additional 
transactions in this segment, they too are appended to the end. 

The most common use of the write request is to print copies of a meeting's transactions 
on a line printer. An option you can choose to format the output pages is the "-format" 
(-fmt) control argument The display consists of a page header containing the current date 
and time, the name of the meeting, and the page number, and a footer containing the subject 
of the first transaction on the page. The header and footer are separated from the text by a 
line of underscores and a blank line. Transactions are only split across pages if they are 
longer than one page. If a transaction does not fit on the remainder of the current page, a 
new page is always created. The -separator control argument may not be used when 
formatting output 

TRANSACTION SPECIFIERS 

You can reference individual transactions or groups of transactions in a meeting by 
using transaction specifiers. The list print, write, delete, retrieve, reset, reply, and apply 
requests all use transaction specifiers. These transaction specifiers can be transaction numbers, 
keywords, the arithmetic operations + and -, person_ids, control arguments, and qedx-type 
regular expressions. 

In addition, you can use the keywords listed below as requests and active requests to 
return transaction numbers. Each transaction specifier causes forum to search the current 
meeting for all transactions that meet a certain criteria spelled out by the transaction 
specifiers; 

Transaction Numbers 

Forum assigns numbers to transactions as it enters them into the proceedings of a 
meeting. When you enter a meeting for the first time, Forum automatically takes you to the 
first transaction, [0001]. You can reference any single transaction by its number (i.e., "print 
3"), reference a range of transactions by putting a colon between numbers (i.e„ "print 1:5"), 
or reference a multiple of individual transactions by numbers separated by a space (i.e., "print 
3 5 9"). 

CURRENT TRANSACTION 

Forum keeps track of the current transaction just as it keeps track of the current 
meeting. As you refer to other transactions, the last one you have dealt with is always the 
current transaction. Suppose you print transaction [0010]. When it has printed and the 
prompt waits for your next request, the current transaction is [0010]. When you then type 
"print +5", Forum prints transaction [0015], that is, current (which Forum knows without 
being told its number) plus 5 equals [0015]. You can use a minus sign (-) in the same 
manner. 
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Keywords 

Keywords let you refer to transactions without knowing their actual numbers. 

| RELATIVE ORDER KEYWORDS 

Forum supplies keywords that let you refer to transactions by their relative order in the 
proceedings. 

all, a 

refers to all transactions (same as firsfclast). 

current, c 

refers to the transaction that was last printed, written or reset 

first, f 

refers to the first transaction in the proceedings. 

last, 1 

refers to the last transaction in the proceedings. 

new 

refers to the transactions that you have not yet seen. 

next, n 

refers to the transaction immediately after the current transaction. 

previous, p 

refers to the transaction immediately before the current transaction. 

unprocessed, u 

refers to the unprocessed transaction (i.e., a transaction that you have typed 
but have not yet entered into a meeting). 

highest, last_seen 

refers to the highest-numbered transaction printed or written. 

CHAIN-TRACING KEYWORDS 

Forum also supplies keywords that specifically deal with transactions that have been 
linked together through the use of the "reply" request (described in Section 4). If you are 
trying to follow transactions in a chain (which are often not entered immediately following 
one another in a meeting), use these keywords: 

allref, aref 

refers to all transactions in the current chain of transactions. 

firstref, fref 

refers to the first transaction in the current chain of transactions. 

lastref, lref 

refers to the last transaction in the current chain of transactions. 
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nextref, nref 

refers to the next transaction in the current chain of transactions. 

previousref, pref 

refers to the previous transaction in the current chain of transactions. 

restref, rref 

refers to all remaining transactions in the current transaction chain, but not 
including the current transaction. 

SEEN I UNSEEN TRANSACTIONS 

Forum remembers whether a user has seen each transaction, not just the most recent 
transaction that has been read. Forum uses the keyword "seen" and "unseen" to mark the 
transactions. For the following group of keywords, "seen" means that the transaction has been 
printed, written, or explicitly marked as seen by the switch_on request "Unseen" means that 
the transaction has not been printed, written, or explicitly marked as seen by the switch on 
request ~ 

seen 

refers to all transactions marked as having been seen. 

first_seen, fs 

refers to the first transaction marked as having been seen. 

last_seen 

refers to the last transaction marked as having been seen. 

next_seen, ns 

refers to the next transaction after the current one which is marked as seen. 

previous_seen, ps 

refers to the first transaction before the current one which is marked as seen. 

new 

refers to transactions entered after your last_seen transaction which were not 
entered by you. 

unseen 

refers to all transactions not marked as having been seen. 

first_unseen, fu 

refers to the first transaction not marked as having been seen. 

last_unseen, lu 

refers to the last transaction not marked as having been seen. 

next_unseen, nu 

refers to the next transaction after the current one which is not marked as 
seen. 

previous_unseen, pu 

refers to the first transaction before the current one which is not marked as 
seen. 
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THE CHAIRMAN'S MESSAGE KEYWORD 

The "chairman_message" (cmsg) keyword refers to the message or greeting that the 
chairman can set up when the meeting is created (or later, with the "set_message" request 
described in Section 8). It is the message printed the first time a user enters a transaction in 
a meeting. This transaction specifier can be used with the print and write requests. Only the 
chairman is allowed to use this specifier with the delete request 

USE OF KEYWORDS AS REQUESTS 

All of the keywords except for "unprocessed" and "chairman_message" can also be used 
as requests. They print the number of the transaction(s) that the keywords refer to. The 
"next", "previous", "next_seen", "previous_seen", "next_unseen", and "previous_unseen M keywords 
and all of the keywords that reference chains can be given an argument to use as the current 
transaction. The argument to these requests must be a transaction number. Thus, "aref 4" 
returns a list of all transaction numbers that refer to transaction [0004]: 

forum: ! aref k 
*» 5 7 10 

forum: 



USE OF KEYWORDS AS ACTIVE REQUESTS 

An active request is a request enclosed in brackets that is first expanded to the 

transaction number(s) it represents before the entire request line is executed. For example, 

"print [aref 4]" expands to "print 4 5 7 10" thus printing all those transactions referring to 
transaction [0004]. 

USE OF KEYWORDS IN PLACE OF TRANSACT/ON NUMBERS 

All keywords except for "unproc", "all", "new", "restref", "allref", "seen", and "unseen" 
can be used in place of actual transaction numbers and can be combined with either "+" or 
"-", as in "lref-1" or "nref+1". To reference from the current transaction use leading "+" 
and "-"; "-4" is the same as "current-4". To specify a range of transactions use two 
transaction numbers or keywords separated by a colon (:), as in "firstlast" or "3:nref". 

Transaction Specification Control Arguments 

Control arguments are another type of transaction specifier that further restrict which 
transactions are selected by a request. A control argument is always preceded by a "-". They 
can be used to specify transactions that were authored by a certain person or that match a 
given character string. Control arguments can also be used to choose transactions based on 
deletion criteria or the date and time they were entered, or to specify that all the 
transactions selected be grouped together by chain. 
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DELETED TRANSACTIONS 

Several requests will operate on deleted transactions when the -include_deleted or 
-only_deleted control arguments are used. Forum considers only those transactions which the 
user can read, so for participants other than the chairman, only deleted transactions entered 
by that participant are considered. All of the chain_tracing keywords and the seen and 
unseen keywords can also use control arguments. Any of the following three control 
arguments can be used with a chain_tracing keyword or a seen or unseen keyword. 

-include_deleted, -idl 

print or return the index of the first unseen transaction in the meeting even if 
it is deleted. 

-only_deleted, -odl 

print or return the index of the first deleted unseen transaction in the meeting. 

-only_non_deleted, -ondl 

print or return the index of the first non_deleted unseen transaction in the 
meeting. (Default) 

PERSONJDS 

The "-from Person_id" control argument indicates that only transactions authored by the 
person identified by Person_id should be selected. Thus, "-from LeeB" selects all transactions 
entered by the participant LeeB. Person_ids cannot contain the asterisk ("*") or period (".") 
characters. 

DATtiTiME SELECTION 

The following control arguments select transactions according to the date and time that 
the transaction was entered. The strings DT, DTI, and DT2 are standard Multics date-time 
strings acceptable to the convert_date_to_binary_ subroutine (described in Multics Subroutines 
and 110 Modules, Order No. AG93). Each must be enclosed in quotes if it contains spaces. 
(Examples are "8/19/83 1500.0 edt Fri", "August 8", "5:00 pm 21 May 1984", and midnight) 

-after DT, -af DT 

""•»" «"» uuujjovuuiu vuiviku v«i v/i aivai uic uifi uauc ajjcwuicu. 1I1C 11II1C Ol 

day is ignored. 

-after_time DT, -aft DT 

selects all transactions entered after the date-time specified. 

-before DT, -be DT 

selects all transactions entered before the date specified. The time of day is 
ignored. 

-before_time DT, -bet DT 

selects all transactions entered before the date-time specified. 

-between DTI DT2, -bt DTI DT2 

selects all transactions entered between the dates specified, inclusive. The times 
of day are ignored. 
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-between_time DTI DT2, -btt DTI DT2 

selects all transactions entered between the date-times specified, inclusive. 

-date DT, -dt DT 

selects all transactions entered on the day specified. 

SORTING TRANSACTIONS BY CHAIN 

* The "-by_chain" control argument can be used to sort selected transactions into 
transaction chains if you are referring to more than one chain of transactions. This is useful 
when, for example, you want to write the last 50 transactions to a segment and you want 
those transactions to be grouped by transaction chain instead of the order they were entered 
into the meeting 

Regular Expressions 

Simple regular expressions are character strings enclosed in slashes (/). They are used 
for selecting transactions which contain a match for a given character string. The control 
arguments "-subject" <-sj) and "-text" (-tx) can be given immediately before a regular 
expression to specify that matching is to be done only against the subject or the text 
respectively. By default, matching is done against both the subject and the text For example, 
"list /television/" lists all transactions which contain the string "television". 

If the regular expression contains spaces, square brackets, or parentheses, it must be 
enclosed in quotes. If it contains quotes, then the quotes inside the slashes must be doubled, 
and the entire regular expression must be quoted. The following is a list of valid regular 
expressions: 

/one/ 

"/one or/" 

/FOR/ 

/:/ 

"/character(s),/" 

"/He said, ""/" 



The null regular expression, //, signifies the last regular expression used. 



3-8 CY74-02 



The string is taken quite literally, i.e., "/television/" will NOT match a transaction 

rnntxinino the st-rina "Television " Tn nrrtsr tr> encnre that cpce i« nnt on icciiA it ic 

recommended that you use "/elevision/" which is still a unique enough string for matching 
only what you want 

The following characters have specialized meanings when used in a regular expression: 

signifies any number (or none) of the preceding character. 

when used as the first character of a regular expression, signifies the 
(imaginary) character preceding the first character on a line. 

$ 

when used as the last character of a regular expression, signifies the (imaginary) 
character following the last character on a line. 

matches any character on a line. 

For more information on regular expressions, refer to the Qedx Text Editor User's Guide, 
Order No. CG40. 

Examples 

The examples below show the use of Forum transaction specifiers combined with the 
"print" (p) request You can use any of the other Forum requests that make sense in each 
case. 

P 14 

prints transaction 14. 

p u 

prints the unprocessed transaction. 

P + 5 

prints the fifth transaction after the current transaction. 

p /budget/ 

prints all transactions containing the string "budget". 

p p:i -from JBSmith 

prints all transactions in the range previous (p) through last (1) entered by 
participant JBSmith. 

p fref 

prints the first transaction in the current chain of transactions. 

p new 

prints all transactions not yet printed or written. 
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p l:c-5 /pll/ -from Baker 

prints all transactions in the range 1 through the 5th before the current that 
contain the string "pll" and were entered by participant Baker, 

p aref /solutions/ -from JohnB 

prints all transactions in the current reference chain that contain the string 
"solutions" and were entered by JohnB. 

p "/one or/" 

prints all transactions containing the string "one or". 

p aref -before 8/19/83 

prints all transactions in the current reference chain entered before 8/19/83. 

p unseen -after_time "2/2/83 12:00 pm" 

prints all transactions entered after noon on 2/2/83 which have not been 
printed or written. 

p -between 12/1/83 12/31/83 

prints all transactions entered in December 1983. 

Examples of transaction specifiers as requests: 

next 

returns the number of the next transaction: 

forum: ! next 
6 

forum: 



In the above example, if the current transaction is 5, when the keyword "next" 
is used as a request, Forum returns "6", the number of the next transaction. 

previous 10 

returns the number of the transaction before transaction 10. 



fref 40 



returns the number of the first transaction in the same reference chain as 
transaction 40. 

aref first 

returns the numbers of all transactions that are in the same reference chain as 
the first transaction. 

next_seen [fu] 

returns the number of the first transaction that has been seen that was entered 
after the first transaction that has not been seen. 
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HOW TO STAY AWARE OF NEW TRANSACTIONS 

Once you begin to follow discussions in a meeting, you'll want to stay aware of new 
transactions in that meeting. You can find out which meetings have changed by using the 
"list_meetings" request with the "-changed" control argument 

forums ! Ism -changed 
Bui letin_board (bb) 
Everybody ' s_Meeting (eve) 
Otherjneetings (meetings) 

forum: 

This request line produces a list of all the meetings found via your forum search list in 
which new transactions have been entered since you last attended. 

If you add the -count control argument to the above request line, the output also tells 
you the number of new transactions in each meeting. 

You can also find out how meetings have changed by using the "check_meetings (ckm)" 
request with the "-list, -Is" control argument The check_meeting request scans the forum 
search list looking for changed meetings (those with new transactions). To use the 
check_meeting request, type: 

forum: ! ckm -Is 
Chan n ed mssti n n s = 25 
Bui letin_board (bb) 3 
Everybody ' s_Meeting (eve) 2 
Mul tics_Picnic (mpic) h 

forum: 

This request line returns the total number of changed meetinp and produces a list of all the 
meetings found via your forum search list which have changed since you last attended. If 
you use the list (Is) control argument with the check_meetings request, the name of each 
changed meeting and the number of new transactions in each meeting is printed. 

You can then use the next_meeting request to successively view the changed rneetingss in 
the list The next_meeting request has the effect of doing a "goto" to the next meeting in 
the changed meeting list 
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Another way to find out if a meeting has changed is to "goto" it As mentioned above, 
when you enter a meeting for the first time Forum sets the current transaction to transaction 
[0001], because you haven't seen any transactions yet As you read transactions, Forum resets 
your current transaction to be the last one that you have seen. In other words, if you enter 
a meeting for the first time and print the first ten transactions, the next time you enter that 
meeting your current transaction is [0010]. The transaction indicator keeps track of the 
current transaction (highest number seen) so that it can keep you informed of new 
transactions. This is done automatically and is relayed to you whenever you enter a meeting: 

forum: ! g bb 

Bui letin_board meeting: 2 new, 15 last. 

The meeting is public. 

forum: 

In the above example you can see that when you enter the Bulletin_board meeting, Forum 
tells you "2 new, 15 last". This means that you have seen the first 13 transactions already, 
and that 2 new ones have been entered since then — transactions 14 and 15 are new and you 
haven't seen them yet If you "list" the transactions in this meeting, you'll see that Forum 
prints an asterisk next to transaction 13, to indicate that 13 is your current transaction. When 
you enter a meeting, your current transaction is the last one you saw (highest-seen) when you 
last attended. You can reset your current transaction with the Forum "reset" request (see the 
forum command description in Section 7). 

If there is a burning issue being discussed in a meeting and you must be aware every 
time a new transaction is entered, tell Forum that you need immediate notification. The 
forum_accept_notifications (fant) command (described in Section 8) informs Forum from 
command level that although you may not be currently attending, you want Forum to send 
you a message every time a new transaction is entered in the specified meeting for the 
duration of this login session. To specify which meeting(s) you want to receive notifications 
about go to the meeting and turn the notify flag (or switch) on with the switch_on request 

! fant 

r 09:59 0.216 23 

! forum 

forum: ! g personal_computers 
personal_computers meeting: 3 new, 5 last. 

forum: ! swn notify 

forum: 

The "switch_on notify" request line turns your notify switch on for that meeting, until 
you explicitly turn it off with the "switch_off" request You can also set the switch from 
outside of the meeting by adding "-meeting personal_computers" to the end of the 
"switch_on" request line. 
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With the notify flag set to on, the next time someone enters a transaction in that 
meeting you will receive a message of the form: 

From Fox.ProjA (forum) 05/18/82 1450.2 edt Tue: 
A new transaction has just been added to the 
>udd>ProjA>mtgs>personal_computers meeting. 

This message from Forum tells you that participant Fox entered a new transaction in the 
personal_computers meeting- But remember, you must issue the forum_accept_notifications 
command every time you log in, even though you need only issue the "switch_on notify" 
request once. Although the notify flag stays turned on permanently (until you request 
otherwise), each time you log in you must explicitly accept the notifications. The 
forum_accept_notifications command can be inserted in your start_up.ec. 

If you need no further notifications, use the "switch_off notify" request to turn the 
notify flag off. If you want to leave the flag turned on but do not wish to receive further 
notifications in your current login session, use the forum_refuse_notifications (frnt) command 
(described in section 9). 

INTERRUPTING LENGTHY OUTPUT 

When you ask for a list of all transactions in a meeting (or anything that fills your 
screen with output), occasionally you may decide that you do not want to wait for all the 
lines to be printed. You can interrupt processing of your request by pressing the QUIT key 
(sometimes labeled ATTN, BREAK, or INTERRUPT). This action takes you out of Forum 
and back to command level; Multics prints QUIT and a ready message containing the word 
"level" and a number. Type the Multics command "program_interrupt" or "pi" (described in 
the Commands manual) to reenter Forum. Your request has been aborted; now you are in the 
request loop and can issue another request. (At this point, the current meeting is still the 
same as before you QUIT. 



forum: 
Trans# 
[0001] 
[0002] 
[0003] 



! list 
Li nes 

(5) 

(3) 

(3) 



Date Time Author 

05/18/81 03:20 Brooks. ProjA 

05/20/81 03:^6 Davis. YAK 

05/21/81 06:49 Smith.ProjB 



Subject 

Reason for this meeting 
Fortran for a Begin<More> 
Other Meetings 



QUIT <USER PRESSED THE INTERRUPT KEY HERE> 
r 14:00 11.304 534 level 2 
! Pi 
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SECTION 4 
SPEAKING 



Once you get the irresistible urge to speak in a meeting, you can choose one of two 
Forum requests to do so: 

• "talk" if you want to speak about a new topic. 

• "reply" if you want to respond to an earlier transaction. 

This section describes how to use these requests, how to edit your transaction before 
entering it into a meeting, how to delete and retrieve any transaction that you've authored. 

OPENING A NEW TOPIC— THE TALK REQUEST 

If you are currently attending a meeting and have something new to say, use the "talk" 
(t) request Forum prompts you for the subject of the transaction: 

forum: i talk 

Welcome to Everybody 's_Meeting 

Subject: 

The message "Welcome to Every body*s_Meeting" is the chairman's greeting message which, if 
set by the chairman, appears the first time you speak in a meeting. (See the "chairman_message" 
transaction specifier in Section 3.) After the "Subject" prompt, type in a title and another 
carriage return. Now Forum responds with another prompt, indicating that you can proceed 
with the text of your transaction. 

forum: ! talk 

Welcome to Everybody ! s_Meeting. 
Subject: ! home computers meeting 
Transact! on? 

As you type in your transaction, keep in mind that the # and @ characters are always 
available for correcting or erasing characters in the line you are currently working on. 

If you're satisfied with entering your transaction as is, without editing it then the 
simplest way to conclude your transaction is to type a period alone on a line, and then a 
carriage return. As soon as you do this, the transaction is entered into the meeting, and you 
receive a confirmation of the form, "Transaction [0015] entered into Everybody's_Meeting." 
This is followed by the Forum prompt, indicating that you have been returned to Forum 
request level. 
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Here is an example of building and entering a transaction while attending a meeting. 
Note the use of the # character to correct a mistake in the message text 

forum: S talk 

Welcome to Everybody' s_Meeting. 

Subject: S home computers meeting 

Transaction: 

Is there sufficient interest too# 

create a meeting for home 

computers? t#To help solve 

problems, some sort of information 

exchange might be useful. 

Any takers?? 

a 

Transaction [00153 entered in >udd>ProjA>Everybody 'sjleeting meeting. 
forum: 

When you end your transaction with a period, however, you miss the chance to check 
and edit it before it is entered into the meeting. Forum has a built-in text editor that gives 
you an easy way to edit your transactions before entering them (see "Editing Your 
Transaction" below). 

COMMENTING ON AN OLD TOPIC— THE REPLY REQUEST 

As we know, the pleasure of a "real" meeting is not just speaking or hearing the 
comments of others, but agreeing with wonderful ideas and challenging the mediocre ones. 
The Forum "reply" (rp) request works much the same as talk, except that your subject line 
contains an automatic reference to the transaction you are replying to, instead of a new 
subject. Assume that you have just printed transaction 15, shown above, regarding 
home_computers and wish to show your support 

forum: ! reply 15 

Subject: Re: home computers meeting 

Transaction: 

! Yes, I second the motion! 

! . 

Transaction [0016] entered in >Udd>ProjA>Everybody 's_Meeting meeting. 

forum: 

The reply request assumes the subject of the reply to be a reference to the subject line 
of the transaction you are replying to. You are then prompted for the text of vour reolv 
('Transaction:"). v J 
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Once your reply is entered, it is linked to the transaction to which it is a reply, 

forming a transaction chain. Transaction chains are very easy to follow via the keywords 

specifically designed to follow the progress of chains (see "Chain-tracing Keywords" in Section 
3). 

EDITING YOUR TRANSACTION 

Forum offers two built-in editors to allow you to change, delete, and add to your 
transaction while you remain in Forum. You can enter them by typing either "qedx" (or qx) 
to enter the Qedx editor or "ted" to enter the Ted editor. 

The Qedx editor is introduced in the New Users' Introduction-Part I, and explained 
fully in the Qedx Text Editor Users' Guide (Order No. CG40). You are strongly 
encouraged to turn to one or both of those manuals, because this manual contains only a 
review of the simplest subset of editor requests. 

Ted is a slightly more sophisticated editor than Qedx, and offers powerful requests and 
macro capabilities. See the Multics Text Editor (TED) Reference Manual (Order No. CP50) 
for a complete description of this editor. In the examples shown in this section, the qedx 
request is used, although you can use the ted request similarly to accomplish the same tasks. 

When you are first typing in your transaction and you want to make changes, type \f 
alone on a line (instead of a period): 

Transaction: 

! <text as shown above> 

! Any takers?? 

! \f 

This enters you into the Qedx editor where you can clean up your transaction. 
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Editor Requests — Qedx 

Once you are in the editor, you issue editor requests as opposed to Forum requests, 
here is a list of basic editor requests {the "$" means the last line in your transaction, 
regardless of its line number): 



REQUEST 


DESCRIPTION 


EXAMPLES 


P 


prints the specified line(s) 


P 


2p 1,3P 


= 


prints the line number of the 
specified line 


= 


$- 


d 


deletes the specified line(s) 


d 


3d l,$d 


a 


adds lines of text after the 
specified line 


a 


2a 


s/o Id/new/ 


substitutes every occurrence of 
the first character string with 


s/hte/the/ 
l,$s/l 1:00/9:30/ 



s/old/new/p 



the second character string, on 
the specified line(s) 

same as above, but also prints 
the changed line 



s/hte/the/p 



To leave the qedx editor, type w (write) to save the changes, and then q (quit) to 
return to the Forum request loop. The write request may be used as often as desired to 
checkpoint the editing process. Note that these are qedx editor requests, not Forum requests 
(the Forum quit request is described under "Exiting Forum" in Section 2; the Forum write 
request is described under "Writing Transactions" in Section 3). 

If the quit (q) request is issued and the transaction has been modified since it was last 
written, the editor will query for permission to exit. If permission is given, any changes 
made since the last write request will be lost. The quit-force (qf in qedx or q in ted) 
request can be used to abort unwanted editing of the transaction without being queried. 

To restore the original transaction text after you have made changes but before you 
issued a write request, type "l,$dr". If you did issue a write request, this sequence will 
restore the text as it was last written. 

Below is an extended example of how the transaction shown above might have been 
constructed. Supplemental comments are displayed to the right of the example. Spaces that 
would not necessarily be in an actual session are included here for clarity. 
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forum: ! talk 

Subject: S home computers meeting 

Transaction: 

! Is there sufficent interest 

! create a meeting for home 

! cmoputers? To§ 

! computers? To help solve 

! problms some sort of information 

! exchange might be useful. 

! Any takers?? 

! \f 

! Is/ce/cie/p 

Is there sufficient interest 

! s/est/est to/ 

I l.$P 

Is there sufficient interest to 
create a meeting for home 

computers? To help solve 
problms some sort of information 
exchange might be might be useful. 
Any takers?? 

1 5 

problms, some sort of information 
i s/lms/lems/p 



<a first draft> 



<enter edit mode> 

<correct one spelling error> 

<add more> 

<pr i nt entire message> 



<print 1 ine 5> 

<correct another error, > 
problems, some sort of information < and print the line > 



! 3d 
! w 

! q 



<delete empty line> 
<save the changes> 
<leave editor> 



forum: 






fVK»«»iuii vi an uiifjiiM.cot>eu iiansttuauri. iou can issue oiner requests 
(i.e., "print" to have another look at it), or further manipulate it Maybe you want to adjust 
the margins or change the subject line. See the next section for more options to use on 
unprocessed transactions. 



If you have typed in a new transaction and do not require the editor at this time, but 
you do not want to enter it into the proceedings of the meeting just yet, end your input 
with "\q" (instead of "." or "\f"). This puts you back at Forum request level where you can 
issue other requests to manipulate your unprocessed transaction. 
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! forums ! talk 

Subject: ! home computers meeting 

Transaction: 
! <Text as shown above> 
! \q 

forum: 

Once you are satisfied with the contents of your transaction, issue the "enter" (en, send) 
request to enter it in the proceedings of the current meeting. 

You can modify the contents of an unprocessed transaction in a number of ways but 
once you enter the transaction in a meeting, it is no longer unprocessed and you can no 
longer manipulate it At request level, you can issue requests that will print, format, re-edit, 
and otherwise perfect the text of your unprocessed transaction. 

Using the Emacs Editor 

If you prefer, you can edit your unprocessed transaction with the Multics Emacs text 
editor, a display-oriented editor designed for use with video terminals. You can call Emacs 
from within Forum via the "apply" (ap) request: 

forum: ! apply emacs 

<system enters Emacs, showing transaction in buffer> 

This places your unprocessed transaction in an Emacs buffer where you can edit it. You must 
save any changes with the Emacs write request ( A X A S) and quit the editor with *X A C. Once 
you quit the editor, you are returned to the Forum request loop where you can enter your 
transaction with the "enter" (e) request. 

For a complete description of the Emacs editor, see the Emacs Text Editor Users' 
Guide, Order No. CH27. 

ENTERING A PRE-WRITTEN TRANSACTION 

The talk and reply requests accept the "-input_file" (-if) control argument which allows 
you to enter a free-standing segment as the text of your transaction. Forum automatically 
supplies the header information, and (with the talk request) prompts you for the subject For 
instance, if your comments were contained in a segment named "home_computers_talk" they 
could be entered in this way: 

forum: ! talk -if home_computers_talk 

Subject: ! home computers meeting 

Use the "enter" request to enter the transaction. 

forum: 

Notice that you are now in possession of an unprocessed transaction. Forum reminds 
you to use the enter request to enter it into the proceedings of the meeting. 
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HANDLING AN UNPROCESSED TRANSACTION 

If you have an unprocessed transaction and you "goto" a different meeting, Forum tells 
you that you left something behind: 

forum (goto): Warning, there is an unprocessed transaction in the 
Everybody 's_Meeting meeting. 

In the above example, you built the transaction in "Everybody's_Meeting" and then attended a 
different meeting without first entering the transaction. The warning message reminds you 
that there is an unprocessed transaction to deal with — probably you'll want to enter it in 
"Everybody's_Meeting" from your current location ("en -meeting eve") or throw it away ("dl 
unproc"). 

You can use the "." (current) request to check the subject and number of lines in your 
unprocessed transaction. For example, if you're attending the meeting in which you created 
the transaction, the output resembles this: 

forum: ! . 

forum 1.8: 72 new, 277 last, 205 current. 

Attending the >udd>ProjA>forum>Everybody 's_Meeting meeting. 

1 1 ine unprocessed. 

subject: home computers meeting 

forum: 

If you're attending a meeting other than the one in which you built the unprocessed 
transaction, the output tells you where that transaction is: 

forum: ! . 

forum 1.8: new, 8 last. 

Attending the >udd>ProjA>mtgs>Other_Meetings meeting. 

1 line unprocessed in the Everybody 1 s_Meeting meeting. 

subject: home computers meeting 

forum: 

If you attempt to exit Forum via the "quit" request while you have an unprocessed 
transaction, Forum warns you that you have an unprocessed transaction (which will be thrown 
away if you quit now) and asks you if you really want to quit before entering your 
transaction in a meeting. 

Manipulating Your Transaction 

If you print your unprocessed transaction, you will see question marks in place of a 
transaction number. Remember that if you don't end a transaction with a period when you 
first type it in, you must explicitly enter it before you exit Forum, or else Forum throws it 
away. Use the Forum "enter" (en, send) request to enter an unprocessed transaction. 
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THE PRINT REQUEST 

The forum J'print" (p) request displays text of the transaction preceded by a version of 
the transaction header that indicates an unprocessed transaction. The example transaction, 
which is your current transaction, is used for illustration: 

forum: ! p 

[????] (3 lines) Your_name.Your_project **UNPROCESSED** 

Subject: home computers meeting 

Is there sufficient interest to 

create a meeting for home 

computers? To help solve 

problems, some sort of information 

exchange might be useful. 

Any takers??? 

-—[????] — 

forum: 



THE FILL REQUEST 

The "fill" (fi) request reformats the text of your transaction by adjusting the right 
margin so that no line has more than a certain number of characters. By default, the 
maximum line length is set at 72 characters but if you prefer, you can specify another length 
with the -linejength (-11) control argument followed by the maximum number of characters 
you want on a line. 

forum: : 'fill -11 50; p 

[????] (U lines) Your_name.Your_project **UNPROCESSED** 

Subject: home computers meeting 

Is there sufficient interest to create a meeting 

for home computers? To help solve problems, some 

sort of information exchange might be useful. Any 

takers??? 

— [????]-— 

forum: 
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THE SUBJECT REQUEST 

The "subject" (sj) request can be used to print the subject of your unprocessed 
transaction: 

forum: ! 

Suppose you decide that you want to change the subject of your 
transaction. The subject request can also be used to change the subject. 
If the new subject contains spaces, it must be quoted. 

forum: ! subject "Personal Computers" 

forum: ! subject 

Subject: Personal Computers 



DELETING TRANSACTIONS 

Transactions can be deleted (and retrieved) as described below. 

The delete Request 

You can delete any transaction that you have entered, for whatever reason, by using the 
Forum "delete" (dl) request, making the transaction unavailable to other participants. Only you 

and the meetine chairman have access to th^m Oniv tvi*» r>viaii-mg« ™« a*****. „ *..„.,„.,.,♦; 

authored by someone else. Your deleted transactions can be read again with the list, print 
and write requests if you give the -include_deleted or -only_deleted control arguments to 
these requests. 

Deleted transactions remain deleted indefinitely but also remain accessible to you until 
the chairman issues the "expunge" request which kills deleted transactions permanently. (See 
"expunge" in Section 7.) 

The retrieve Request 

It is also possible, once you have deleted a transaction, to retrieve it again and thus 
re-enter it into the meeting. The "retrieve" (rt) request does just that. Only transactions that 
were deleted by you (and therefore authored by you) can be retrieved by you. Only the 
chairman can retrieve a transaction deleted by someone else. See the full description of the 
retrieve request in Section 7, 

If the chairman has issued the "expunge" request since the transaction was deleted then 
it cannot be retrieved. 
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SECTION 5 
HOW TO GET HELP 



Forum supplies several help requests that give you information about Forum requests in 
graduated levels of detail. 

THE ? REQUEST 

When you forget the short name of a request or need to be reminded of the names of 
any of the basic requests, use the "?" request It prints a memory-jogging list of the most 
important requests. 



goto, g, go 
list, Is 
print, p, pr 
quit, q 

addjneeting, am 
announce_meeting, anm 
announcement^ nfo, ai 
apply, ap 
chairman, cm 
check_meetings, ckm 
current_meeting, cmtg 
delete, dl , d 



enter, en, send 
fill, fi 
forum_dir, fd 
1 ist_meetings, Ism 
list_users, lsu 
mai 1 

next_meeting, nm 
qedx, qx 

remove meeting, rm 

reply, rp 
reset, rs 
retrieve, rt 
subject, sj 



switch_off, swf 

switch_on, swn 

talk, t 

ted 

write, w 

help 

1 ist_help, lh 

1 ist_requests, lr 

abbrev, ab 

exec_com, ec 

dc 

if 

answer 

execute 
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THE LIST\_REQUESTS REQUEST 

The "list_requests" (lr) request gives you a one-line description of each Forum request 
— »„_ „.„, j„„ „ WTT j»,„ „„?* )vu wivu miu a winuidiiu iiuv uj iviuiuut irom wiuiin rorum 
and how you can get more detailed help on any of the requests in this list 

forum: ! 1 ist_fequests 
Summary of forum requests: 

Use "..COMMAND J. I NE" to escape a command line to Multics. 

Type "listjielp" for a list of topics available to the help request. 

Type "help TOPIC" for more information on a given topic. 

Print current status. 

n f!p Obtain detailed information on forum, 

listjielp, lh List topics for which help is available. 

1 ist_requests, lr List brief information on forum requests, 

quit, q Exit forum, 

goto, g, go Enter a meeting, 

print, p, pr Print the specified transactions, 

list, Is List the specified transactions, 

abbrev, ab Turn abbreviation processing on or off. 



forum 



There are many more requests that normally appear in the list but are not displayed in 
this example. 

THE LIST_HELP REQUEST 

The "listjielp" (lh) request gives you a list of every single possible Forum request, or a 
list of requests related to the TOPIC that you name. For example: 

forum: ! listjielp ready 
Topics available for forum: 

ready_off 

ready_on 

ready 

forum: 

You can ask for detailed, specific help on any topic returned by listjielp by naming it as 
the TOPIC argument to the "help" request {described below). 
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THE HELP REQUEST 

For detailed information on how to use a particular Forum request, type "help" 
followed by the name of the request (i.e„ "help reply"). The "help" request offers complete 
information on every Forum request and on other selected topics concerning Forum. 

The "help" request enters you into a sub-request loop, asking you at several points if 
you want more information ("More help?"). The most basic answers to this prompt is either 
"yes" or "no". A response of "?" gives you a list of all possible answers known to the help 
request For a more detailed explanation of the help request see Section 8. 

WHERE AM I? 

If you've lost your place in the request loop, you can find out exactly where you are 
at any time with the Forum "." (dot) request If you are not currently attending a meeting, 
it simply gives you Forum's version number: 

forum: ! . 
forum 1.10 

forum: 



If you are attending a meeting, it tells you the location of the meeting and transaction 
information in addition to Forum's version number: 

forum: ! . 

forum 1.10: 9 new, 10 last. 

Attending the >udd>ProjA>forum>Everybody's_Meeting meeting. 

forum: 

If you have seen some, but not all, of the transactions in this meeting, this request gives you 
the number of the last transaction you saw. 



mis request aiso iciis you n you nave any unprocessed transactions ^unprocessed 
transactions are created when you speak in a meeting — they are fully described in Section 4). 
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SECTION 6 
ADVANCED FORUM FEATURES 



Many of the Forum components already discussed, such as control arguments on the 
command line, transaction editing, and powerful request language, have additional features that 
enable you to use Forum to perform more specialized functions. These advanced techniques 
derive their strength by using command level capabilities from within Forum. 

CONTROL ARGUMENTS AND REQUESTS 

Almost all Forum requests take control arguments. Here are some examples showing a 
specialized usage of the list_users request 

To find out if the user JPSea is a participant of the current meeting, type: 
forum: ! lsu -user JPSea 

and if she is, Forum prints the summarization line showing last transaction seen last time 
attended, and any flags for JPSea. 

To get a listing of all users who are currently attending the meeting, type: 
forum: ! lsu -attending 



ACTIVE REQUESTS 

— ._»,.._„.. „ „. n^uwt llllw wiwivrasw hi uia^KCLs mai is iirsi expanded to its 

return value before the entire request line is executed. The following is a list of Forum 
active requests: 



current_meeting, cmtg 

do 

exec_com, ec 

execute, e 

forum_dir, fd 

if 

list, Is 



list_meetings, Ism 
list_users, lsu 
next_meeting, nm 
subject, sj 
subsystem_name 
subsystem_version 



6-1 



CY74-02 



The "cmtg" active request returns the pathname of the current meeting you are 
attending. Wherever you type "[cmtg]" on a request line, Forum replaces that with the name 
of the current meeting. One way of using this active request is: 

forum: ! write -pn [cmtg] 

which places the current transaction in a saved segment with the name of the current meeting 
as its name. 

With the "e" active request, you can incorporate Multics active functions into Forum 
request lines. Here are a few examples: 

forum: ! write 3 -pn [e home_di r]>fel ine 
for saving transaction [0003] in a segment named "feline" in your home directory; 
forum: ! Ism -part -user [e last_message_sender] 

for determining which meetings the user who last sent you an interactive message participates 
in; 

forum: ! pr -date [e date] 
for printing all transactions in the current meeting that were entered today. 

For a detailed discussion of the usage of each active request, refer to section 8. 

ESCAPING TO COMMAND LEVEL 

There are several ways to use the Multics command environment while you remain 
inside Forum. This ability can be handy for a variety of purposes. 

The ..command line Escape 

To issue a Multics command within Forum, simply type two periods directly after the 
prompt, followed by the command line: 

forum: ! ..who 
When the command has finished, you receive another Forum prompt 

You can use this escape to check on which saved transactions you have in your 
directory ("..list") and to attend to other Multics activities when they occur to you ("..sm 
Brie.ProjDog Let's eat.") without having to end your Forum session prematurely. 
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You are free to use any command language conventions and facilities in the same way 
you _o ou*su.e i orum. Active * unctions ^discussed in the New Users' Introduction — Part II) 
are especially useful in providing the command language with extra flexibility. Here are two 
examples: 

forum: ! ..sm [last_message_sender] Sure, I'm hungry too 
forum: ! ..eor [home_dir]>canine.mai 1 

Standard quoting and semicolon conventions also apply when using the ..COMMAND LINE 
escape. " ~ 

Forum requests and active requests can not be used with the ".." TequesL The command 
line is made up of Multics commands and active functions only. 

The execute Request 

The "execute" (e) request performs a function very similar to that of the ,.COMM4.ND_LINp 
escape, because it also passes the rest of the line to command level to be acted on. Before 
the command line reaches command level, however, it passes through the Forum request 
processor. This means that all forum active requests (which are enclosed in brackets as 
described above) get processed first The results are placed in the request line, and then the 
line gets processed as a command line. To illustrate with the cmtg active request, which 
returns the pathname of the meeting you are currently attending, you can type: 

forum: ! execute list [cmtg]. trans 
which expands to: 

forum: execute list Everybody 's_Meeting. trans 
to see whether you have saved any transactions with the default name of the current meeting. 

CONDITIONAL EXECUTION (THE IF REQUEST) 

There may be times when you want to execute a request only on certain conditions, or 

execute a reaiiest if a condition is mpt nnri anntVi*»r if it ic ««t -««» Ti — *» nirn '..--^ 

allows you to conditionally execute one of two request lines depending on the value of a 
returned active string. For example: 

forum: ! if [e exists seg [cmtg] .trans] -then "e dl [cmtg] .trans; w new" 
-else "w new" 

which asks if a segment named <current_meeting>.trans exists in your working directory, then 
delete it and write all the new transactions in the current meeting to the default segment 
named <current_meeting>.trans. If the segment does not exist, then simply write the new 
transactions to the segment. The active strings being expanded here are Forum active requests 
Thus, to execute a Multics active request, the "e" active request must be used. The actions to 
take follow the -then and -else control arguments, and they must be enclosed in quotes if 
they contain spaces or other command language characters. If the "-else" action is not 
specified and the condition returns "false", no action is taken. 
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The if active request returns one of two character strings to the Forum request 
processor depending on the value of an active string. For example, 

forum: ! write all [if [e equal [subsystem_version] 1.10] 
-then "-by_chain -format" -else "-fill"] 

which will execute the request line "write all -by_chain -format" if the subsystem_version is 
1.10, or "write all -fill" if it is not 

THE MAIL REQUEST 

If you want to send a transaction or set of transactions to other users, mailing lists, or 
Forum meetings you can use the forum mail request To send transactions to another user: 

forum: ! mail 10 11 12 -to McElvenny.Pubs 

!. 

Mail delivered to McElvenny.Pubs 

forum: 

This request line sends transactions 10 through 12 to the mailbox of McElvenny.Pubs. Within 
the mail system the User_id is considered one form of address, because the mail system uses 
this information to deliver the transactions to the correct mailbox. 

To send transactions to Forum meetings: 

forum: ! mail 10 11 12 -to -meeting >si te>forum_di r>picnic_talk 

! . 

Mail delivered to >si te>forum_di r>picnic_talk 

forum: 

This request line sends transactions 10 through 12 to the picnic_talk forum meeting. If you 
give just an entryname (no ">" or "<" characters) instead of the absolute pathname, the 
forum commands search path is used to find the meeting. For more information on the mail 
request, see "Forum Request Description" later in this manual. For more information on the 
Multics mail system, refer to the Multics Extended Mail System Users' Guide, Order No. 
CH23. 

THE FORUM COMMAND 

Many forum command control arguments have been described in earlier sections of this 
manual. They allow you to personalize youT Forum environment All of the forum command 
control arguments are described in the forum command description in Section 8. 

To illustrate a few simple possibilities, here are some sample command lines using some 
control arguments that have not previously been discussed: 

forum -meeting mgrjneeting -list -quit 
forum -abbrev -brief 
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The first Forum command line above enters Forum, goes to the mgr_meeting meeting, lists all 
transactions, and quits, returning you directly to command level. The second example invoices 
Forum with abbreviation processing turned on and the briefest form of the Forum messages 
are to be printed. 

forum -prompt Next -output_fill 
forum -meeting pubs -no_prompt 

The first example above enters Forum, prompts you with "Next" instead of "forum:" and fills 
all transactions before writing or printing them. The second example enters the pubs meeting 
and asks that you not be prompted at all in the request loop. 

forum -meeting mgr_meeting -rq "write new -pn [e hd]>my; quit" 

This command line enters the mgr_meeting meeting, writes any new transactions into a 
segment named my.trans (in your home directory), and exits Forum. 

USING ABBREVIATIONS 

If you are using one particular Forum command line frequently, you will find that 
creating an abbreviation for the command line, with the abbrev command, is a much simpler 
way of specifying that information. Here is how to use the abbrev command to make an 
abbreviation for one of the example command lines above: 

! .ab my_forum forum -prompt Next -output_fi'l 

Now when you want to enter forum with "Next" as your prompt, and to have your 
transactions filled on output, type "my_forum". In the example above, it is assumed that you 
have abbreviation processing turned on for your process. Refer to the New Users' 
Introduction — Part II for details concerning the abbrev command and the creation of 
abbreviations. 
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There is a whole set of "inverse" control arguments that are useful for reversing the 
effect of one (or more) of the control arguments you have included in an abbreviation. If 
for example you do not always want your transactions filled on output, you can type 
"my_forum -no_output_fill" which is expanded into the command line: 

forum -prompt Next -output_f i 1 1 -no_output_f i 1 1 

Whenever conflicting control arguments appear on a command line, Forum uses the last one 
to appear. Thus the above example restores the default filling action. 

The abbrev Request 

Abbreviations are a shorthand version of an otherwise lengthy or often-used request 
line. You must either use the -abbrev control argument when you invoke forum or use the 
Forum "abbrev" request to initiate abbreviation processing within the current Forum session. 
Forum abbreviations can either be defined at Multics command level or from within Forum 
via the ".." request. 

You may want to define an abbreviation for the "talk" request, such as the one shown 
below which, upon termination of input, places your unprocessed transaction in an Emacs 
buffer for editing: 

! .ab T do "talk -rql; apply emacs" 
This abbreviation contains two request lines, thereby requiring the use of the "do" command. 

FORUM EXEC_COMS 

If you have specific" sets of Forum requests that you use frequently, you can put them 
together in an exec_com segment which can be executed via the Forum "exec_com" (ec) 
request The Forum exec_com segment can be written in either version 1 or version 2 
exec_com (see the Commands manual) and must have the suffix of ".fmec". It is just like a 
Multics exec_com segment except that it contains forum request lines instead of Multics 
command lines. This means that to execute Multics commands from within the exec_com, you 
must use the "execute" request, and with Multics active functions, use the "e" active request 
The following example shows the contents of a forum exec_com, and the method of executing 

Contents of [home_di r]>sample_ec.fmec: 

(1) &command_l ine off 

(2) e cwd [e hd] 

(3) goto 61 

(4) if [e exists seg [cmtg] .trans] -then "e dl [cmtg] .trans" 

(5) w new -after "Sunday - lweek" -format -by_chain -bf 

(6) e eor [cmtg]. trans ~ 

(7) 6quit 

forum: ! ec sample_ec eve 
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The "sample_ec.fmec" program executes the following: 

(1) changes your working directory to your home_dir. 



(2) 



goes to the meeting you specified as an argument to the exec com request 
("eve"). ~ 



(3) checks to see if a segment named "Everybody 's_meeting. trans" exists in your 
home directory and if it does, delete it. 

(4) writes all new transactions that were entered after Sunday (i.e., this week's new 
transactions) to a segment with the default pathname of 
[home_dir]>EveTybody's_meeting.trans. The transactions are sorted by chain, 
formatted for output, and no message is printed if no transactions were 
selected. 

(5) prints the segment on the default line printer. 

The forum request 

forum: ! ec sample_ec ([ism -changed]) 

executes the sample_ec exec_com for every meeting that has changed as returned by the 
list_meetings active request 

Forum searches the "exec_com" search list for segments with the ".fmec" suffix. An 
absolute pathname can also be specified which bypasses the search facility. 

The Forum Start_up Exec_.com 

When forum is invoked, it searches for a start-up segment with the name "start_up.fmec". 
The start_up exec_com creates a specially tailored forum environment every time you enter 
forum. This segment is a Forum exec_com segment written in either version 1 or version 2 
exec_com with Forum request lines. A sample start_up.fmec segment written in version 1 
exec_com is shown below. 

&command 1 ine off 

ab 

Ism -changed -no_adjourned -long 

Squit 
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This start_up turns on abbreviation processing and lists all meetings in which you are a 
participant that have changed, not including adjourned ones. If no meetings have changed, the 
message "No meetings have changed" will be printed instead. If you supplied the name of a 
meeting to attend on the forum command line, this information will be printed before 
entering the specified meeting and being placed in the forum request loop. 

The directories that are searched for start_up.fmec are your home directory, your 
project directory, and >site, in that order. 

The forum command allows you to bypass execution of the start_up exec_com with the 
"-no_start_up" control argument 

FORUM AND YOUR PROCESS START_UP 

Another method of setting up your own Forum environment is to place a Forum 
command line at the end of your process start_up exec_com segment For example: 

fant; forum 

tells Forum that from the time you log in, you want to be notified of any new transactions 
in any meetings where you have previously asked for immediate notification of new 
transactions (with the switch_on request). The rest of the command line tells Multics to enter 
you immediately into Forum while executing your process start_up. 
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SECTION 7 
FORUM REQUEST DESCRIPTIONS 



This section contains descriptions of the Forum requests, presented in alphabetical order. 
These requests are for all users except where otherwise noted. Each description contains the 
name of the request (including the abbreviated form, if any), discusses the purpose of the 
request, and shows the correct usage. Notes and examples are included when deemed necessary 
for clarity. The discussion below briefly describes the content of the various divisions of the 
request descriptions. 

Name 

This heading lists the full request name and its abbreviated form. 

Syntax 

This part of the request description shows a single line that demonstrates the proper 
format to use when using (invoking) the request Any elements in the line that follows the 
name of the request are explained under subsequent headings. 

The following conventions apply in the syntax line: 

1. Optional arguments are enclosed in braces (e.g., {path}, {User_ids}). All other 
arguments are required. 

2. Control arguments are identified in the usage line with a leading hyphen (e.g., 
{-control_args} ) simply as a reminder that all control arguments must be 
preceded by a hyphen in the actual invocation of the request 

Function 

This heading discusses the purpose and function of the request and what happens when 
you use it 

Arguments and Control Arguments 

These headings describe the other elements shown in the "Syntax" line, which tell Forum 
exactly what it should perform the request on, and specifically how it should be performed. 
Common arguments are meeting_name (the name of the meeting), STR (any character string), 
and N (an integer). 
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Control arguments are always preceded by a "-" character, and are typed as you see it 
(i.e., -off, -on). They sometimes have a short name as well as a long name (i.e., -brief, 
-bf). Some control arguments also have another argument associated with it as in "-date DT" 
where DT is a date-time value (i.e., -date "08/30/83 11:30 edt"). If any of these arguments 
contain spaces, parentheses, or quote characters, they must be enclosed in quotes. 

Notes 

Comments or clarifications that relate to the request as a whole are given under the 
"Notes" heading. Also, where applicable, the required access modes, the default operation 
(when invoked without arguments), and any special case information are included. 

Examples 

The examples show different valid invocations of the request An exclamation mark (!) 
is printed at the beginning of each line typed by the user. This is done only to distinguish 
user-typed lines from system-typed lines. The results of each example request line are either 
shown or described. 

Other Headings 

Additional headings are used in some descriptions, particularly the more lengthy ones, to 
introduce specific subject matter. These additional headings may appear in place of, or in 
addition to, the notes. 
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• (current) ..command line 



Name: . (current) 
SYNTAX 

FUNCTION 

prints information about the current version of Forum, the meeting the user is attending (if 
any) and the unprocessed transaction (if any). The format of the output is: 

forum 1.8: new, 220 last, 220 current. 

Attending the >udd>Company>meetings>excursions meeting. 

12 lines unprocessed. 

subject: Re: picnic 

If the user is attending a meeting, the number of new (unseen) transactions, the transaction 
number of the last transaction, and the number of the current transaction are printed. If the 
user has built a transaction but not yet entered it into a meeting, the subject and number of 
lines in that transaction are printed. If the user is about to enter an unprocessed transaction 
in a meeting other than the current meeting, this request also prints the name of the meeting 
that the transaction will be entered in (e.g., "12 lines unprocessed in the eve meeting." if 
attending the excursions meeting but entering a transaction in the eve meeting). 



Name: ..command line 

SYNTAX 

. .command_l ine 

FUNCTION 

executes a Multics command line from within the Forum request loop. 

ARGUMENTS 

commandjine 

is any Multics command line. When the command has executed, you are returned to the 
Forum request loop. 
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abbrev abbrev 

Name: abbrev, ab 

SYNTAX 

ab {-control_args} 

FUNCTION 

controls abbreviation processing within Forum. 

CONTROL ARGUMENTS 

-off 

specifies that abbreviations are not to be expanded. 

-on 

specifies that abbreviations should be expanded. (Default) 

-profile PATH 

specifies that the segment named by PATH is to be used as the profile segment; the 
suffix ".profile" is added to PATH if not present The segment named by PATH must 
exist 

NOTES 

Forum provides command line control arguments (-abbrev, -no_abbrev, -profile) to the forum 
command to specify the initial state of abbreviation processing. 

If invoiced with no arguments, this request enables abbreviation processing within Forum using 
the profile that was last used in this Forum invocation. If abbreviation processing was not 
previously enabled, the profile in use at Multics command level is used; this profile is 
normally [home_dir] >Person_id.profile. 

See the abbrev command in the Commands manual for a description of abbreviation 
processing. 
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add_meeting add_meeting 



Name: add meeting, am 

SYNTAX 

am {trans_specs} {meet i ng_names} {-control_args} 

FUNCTION 

adds meetings to the user's forum search list by placing links to them in the directory 
>udd>Project>Person>meetings and makes the user a participant in the meeting. 

ARGUMENTS 

trans_specs 

are transaction specifiers identifying transactions created by the announce_meeting request. 
If any trans_specs are given, they must precede all meeting_names. At least one 
trans_spec or meeting_name must be given. For more information on transaction 
specifiers, refer to "Reading Transactions" later in this manual. 

meeting_names 

are pathnames of forum meetings to be added to the search list 

CONTROL ARGUMENTS 

-current_meeting, -cmtg 

adds the current meeting to the search list. 

-directory PATH, -dr PATH 

places the links in the specified directory instead of the default directory of 
>udd>Project>Person>meetings. 

-force, -fc 

adds the link even if the user is not eligible to participate in the meeting. 

-no_force, -nfc 

does not add the link if the user is not eligible to participate in the meeting. (Default) 

-update, -ud 

changes all links to version 1 meetings into links to a version 2 meeting if that meeting 
exists in the directory that the link points to. For more information on version 1 and 
version 2 forum meetings, refer to "Duties of the Chairman" later in this manual. 

LIST OF TRANSACTION SPECIFICATION CONTROL ARGUMENTS: 

-after DT, -af DT 

selects transactions entered on or after the the date specified. The time of day is 
ignored. 

-after_time DT, -aft DT 

selects transactions entered after the date_time specified. 
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I 



add_meeting add_meeting 



-before DT, -be DT 

selects transactions entered before the date specified. The time of day is ignored, 

-before_time DT, -bet DT 

selects transactions entered before the date_time specified. 

-between DTI DT2, -bt DTI DT2 

selects transactions entered between the dates specified, inclusive. The times of day are 
ignored. 

-between_time DTI DT2, -btt DTI DT2 

selects transactions entered between the date_times specified, inclusive. 

-date DT, -dt DT 

selects transactions entered on the day specified. 

-from Person_id, -fm Person_id 

selects transactions entered by the participant named Person_id. 

-include_deleted, -idl 

prints or returns the index of the first unseen transaction in the meeting even if it is 
deleted. 

-only_deleted, -odlw 

prints or returns the index of the first deleted unseen transaction in the meeting. 

| -only_non_deleted, -ondl 

I prints or returns the index of the first non_deleted unseen transaction in the meeting. 

| (Default) 

-subject /regexp/, -sj /regexp/ 

selects transactions whose subjects match the given regular expression. 

-text /regexp/, -sj /regexp/ 

selects transactions whose subjects match the given regular expression. 

| NOTES 

If the directory >udd>Project>Person>meetings does not exist, and the -directory control 
argument is not given, a link with that name pointing to >udd>Project>Person is created in 
>udd>Project>Person. 
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add__participant add_project 



Name: add participant, apt 

SYNTAX 

apt person_id {-control_args} 

FUNCTION 

makes the person identified by Person_id eligible to participate in the current meeting. You 
can use this request if you have either modify permission on the containing directory or 
chairman access to the meeting. 

ARGUMENTS 

person_id 

is the Person_id of the participant to be added. 

CONTROL ARGUMENTS 

-chairman, -cm 

gives chairman access (c) to the added participant. This control argument is not valid for 
meetings created with pre-MRll software. 

-read_oniy, -ro 

allows the added participant to read transactions but not to enter them. 

NOTES 

The -read_only and -chairman control arguments cannot both be specified. For information 
on converting a meeting, refer to "Duties of the Chairman" later in this manual. 



Name: add nrniert. ani 

SYNTAX 

apj projected {-control_args} 

FUNCTION 

Allows users from the project identified by projected to become participants of the current 
meeting. You can use this request if you have either modify permission on the containing 
directory or chairman access to the meeting. 

ARGUMENTS 

projected 

is the Projected for the project to be admitted to the meeting. 
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add_project announce_meeting 



CONTROL ARGUMENTS 

-chairman, -cm 

gives chairman access (c) to the added project This control argument is not valid 
for meetings created with pre-MRll software. 

-read_only, -ro 

allows users on the added project to read transactions but not to enter them. 

NOTES 

The -read_only and -chairman control arguments cannot both be specified. For 
information on converting a meeting, refer to "Duties of the Chairman" later in this 
manual. 



Name: announce meeting, anm 

SYNTAX 

anm {-control_argument} 

FUNCTION 

places an announcement of the current meeting in another meeting. This announcement 
can be used with the add_meeting request by other users in order to add this meeting 
to their search list 

CONTROL ARGUMENTS 

-enter_description, -eds 

prompts the user for a textual description of the meeting instead of using the 
text of the first transaction in the announcement. 

-meeting MEETING, -mtg MEETING 

specifies the name of the meeting where the announcement is to be placed. If 
-meeting is not given, the announcement is placed in the site's default directory, 
normally >si te> f orum_dir > Meetings_Directory. 






announcement_info announcement_info 



Name: announcement_info, ai 

SYNTAX 

ai {trans_spec} {-control_args} 

SYNTAX AS AN ACTIVE REQUEST 

[ai {trans_spec} -control_arg] 

FUNCTION 

Extracts infonnation from a meeting announcement produced by the announce_meeting request 
ARGUMENTS 

trans_spec 

is a transaction specifier designating the transaction containing the meeting announcement 
An error occurs if this does not refer to a transaction entered by announce_meeting. See 
Section 3 for more information on transaction specifiers. Only one transaction may be 
selected. 

CONTROL ARGUMENTS 

-absolute_pathname, -absp 

print ot return the absolute pathname of the announced meeting. 

-chairman, -cm 

print or return the user_id of the chairman of the announced meeting. 

-entry_name, -etnm 

print or return the entry name of the announced meeting. 

LIST OF TRANSACTION SPECIFICATION CONTROL ARGUMENTS: 

-after DT, -af DT 

selects transactions entered on or after the the date specified. The time of day is 
ignored. 

-after_time DT, -aft DT 

selects transactions entered after the date_time specified. 

-before DT, -be DT 

selects transactions entered before the date specified. The time of day is ignored. 

-before_time DT, -bet DT 

selects transactions entered before the date_time specified. 

-between DTI DT2, -bt DTI DT2 

selects transactions entered between the dates specified, inclusive. The times of day are 
ignored. 
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announcement_info answer 



— uetween_time DTI DT^, — btt DTI DT2 

selects transactions entered between the date_times specified, inclusive. 

-date DT, -dt DT 

selects transactions entered on the day specified. 

-from Person_id, -fm Person_id 

selects transactions entered by the participant named Person_id. 

-subject /regexp/, -sj /regexp/ 

selects transactions whose subjects match the given regular expression. 

-text /regexp/, -tx /regexp/ 

selects transactions whose subjects match the given regular expression. 



Name: answer 

SYNTAX 

answer STR {-control_args} request_l ine 

FUNCTION 

provides preset answers to questions asked by another request. 

ARGUMENTS 

STR 

is the desired answer to any question asked by request_line. If the answer is more than 
one word, it must be enclosed in quotes. If STR is -query, the question is passed on to 
the user. The -query control argument is the only one that can be used in place of 
STR. 

request_line 

is any Forum request line. It can contain any number of separate arguments (i.e., have 
spaces within it) and need not be enclosed in quotes. 

CONTROL ARGUMENTS 

-brief, -bf 

suppresses printing (on the user's terminal) of both the question and the answer. 
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answer answer 



-call STR 

evaluates the active string STR to obtain the next answer in a sequence. The active string 
is constructed from Forum active requests and Multics active strings (using Forum's 
"execute" active request). The outermost level of brackets must be omitted (ie: 
"forum_list -changed") and the entire string must be enclosed in quotes if it contains 
request processor special characters. The return value "true" is translated to "yes", and 
"false" to "no". All other return values are passed as is. 

-exclude STR, -ex STR 

passes on, to the user or other handler, questions whose text matches STR. If STR is 
surrounded by slashes (/), it is interpreted as a qedx regular expression. Otherwise, 
answer tests whether STR is literally contained in the text of the question. Multiple 
occurrences of -match and -exclude are allowed (see "Notes" below). They apply to the 
entire request line. 

-match STR 

answers only questions whose text matches STR. If STR is surrounded by slashes (/), it 
is interpreted as a qedx regular expression. Otherwise, answer tests whether STR is 
literally contained in the text of the question. Multiple occurrences of -match and 
-exclude are allowed (see "Notes" below). They apply to the entire request line. 

-query 

skips the next answer in a sequence, passing the question on to the user. The answer is 
read from the user_,i/o I/O switch. 

-then STR 

supplies the next answer in a sequence. 

-times N 

gives the previous answer (STR, -then STR, or -query) N times only (where N is an 
integer). 

NOTES 

Answer provides preset responses to questions by establishing a unit for the condition 
command_question and then executing the designated request line. If any request in the 
request line calls the command_query_ subroutine (described in the Subroutines manual) to ask 
a question, the on unit is invoked to supply the answer. The on unit is reverted when the 
answer request returns to Forum request level. See the Multics Programmers' Reference 
Manual, Order No. AG91 for a discussion of the command_question condition. 

If a question is asked that requires a yes or no answer and the preset answer is neither "yes" 
nor "no", the on unit is not invoked. 

The last answer specified is issued as many times as necessary, unless followed by the -times 
N control argument 
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answer apply 



The -match and -exclude control arguments are applied in the order specified. Each -match 
causes a given question to be answered if it matches STR; each -exclude causes it to be 
passed on if it matches STR. A question that has been excluded by the -exclude control 
argument is reconsidered if it matches a -match later in the request line. For example, the 
request line: 

! answer yes -match /fortran/ -exclude /fortran_io/ -match / A fortrart_io/ 

answers questions containing the string "fortran", except that it does not answer questions 
containing "fortran_io". It does, however, answer questions beginning with " A fortran_io". 



Name: apply, ap 

SYNTAX 

ap {trans_specs} {-control_args} command_line 

FUNCTION 

places the text of the specified transaction into a temporary segment, appends the pathname 
of this segment to the end of command_line, and executes the resulting Multics command 
line. If an unprocessed transaction is specified, the transaction text is updated from the 
contents of the temporary segment after execution. 

ARGUMENTS 

trans_specs 

are transaction specifiers (see "List of transaction specification control arguments" below). 
If no trans_specs are given, the unprocessed transaction is selected. If there is no 
unprocessed transaction, one is created. See Section 3 for more information on 
transaction specifiers. 

command_line 

is any Multics command line. 

CONTROL ARGUMENTS 

-by_chain 

specifies that transactions are to be grouped by transaction chain. 

-fill, -fi 

specifies that the unprocessed transaction is to be refilled upon return from the 
command. This is the default unless the -no_input_fill control argument was given to the 
forum command or unless the -no_fill control argument was given to the talk or reply 
request 
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apply apply 



-inciude_deleted, -idl 

processes transactions even if they have been deleted. See "Notes" below. Default is 
-only_non_deleted. 

-initial 

processes only the transactions that are first in transaction chains. 

-no_fill, -nfi 

specifies that the unprocessed transaction is not to be refilled upon return from the 
command. (Default) 

-only_deleted, -odl 

processes only deleted transactions. See "Notes" below. Default is -only_non_deleted. 

-only_non_deieted, -ondl 

processes only non-deleted transactions. (Default) 

-reverse, -rv 

causes transactions to be processed in the reverse order that they were given in the 
transaction specifier. 

LIST OF TRANSACT/ON SPECIFICATION CONTROL ARGUMENTS 

-after DT, -af DT 

selects transactions entered on or after the the date specified. The time of day is 
ignored. 

-after_time DT, -aft DT 

selects transactions entered after the date_time specified. 

-before DT, -be DT 

selects transactions entered before the date specified. The time of day is ignored. 

-before_time DT, -bet DT 

selects transactions entered before the date_time specified. 

-between DTI DT2, -bt DTI DT2 

selects transactions entered between the dates specified, inclusive. The times of day are 
ignored. 

-between_time DTI DT2, -btt DTI DT2 

selects transactions entered between the date_times specified, inclusive. 

-date DT, -dt DT 

selects transactions entered on the day specified. 

-from Person_id, -fm Person_id 

selects transactions entered by the participant named Person_id. 
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apply chairman 



-subject /REGEXP/, -sj /REGEXP/ 

selects transactions whose subject matches the given regular expression. 

-text /REGEXP/, -tx /REGEXP/ 

selects transactions whose text matches the given regular expression. 

NOTES 

The supplied command line need not be enclosed in quotes. However, if it contains 
parentheses, square brackets, semicolon, or quote characters they should be enclosed in quotes 
to prevent processing by Forum's request processor. 

If more than one transaction is selected, the command line is applied to each selected 
transaction in turn. In order to select a deleted transaction, the user must either be the 
chairman of the meeting or the author of the deleted transaction. 

EXAMPLES 

This request can be used to edit the transaction with an editor other than qedx or ted. For 
example, the request 

! apply emacs 
will invoice the emacs editor on the transaction. 



The request: 

! apply aref send_mail Smith -sj Transactions -if 
will send each transaction in the current chain as mail to the user Smith. 



Name: chairman, cm 

SYNTAX 

cm {meeting} {-control_args} 
SYNTAX AS AN ACTIVE REQUEST 
[cm {meeting}] 
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chairman check_meetings 



FUNCTION 

prints or returns the User_id (Person_id.Project_id) of the chairman of the specified meeting, 
or changes the chairman of the current meeting. If no arguments are given, the name of the 
chairman of the current meeting is printed. 

ARGUMENTS 

meeting 

is the name ot pathname of a Forum meeting. 

CONTROL ARGUMENTS 

-force, -fc 

tells Forum not to ask if the chairman should be changed when using the -set control 
argument 

-set new_chairman 

changes the chairman of the current meeting. new_chairman must be of the form 
Person_id.Project_id. Only the current chairman is allowed to change the chairman. 



Name: check meetings, ckm 

SYNTAX 

ckm {meeting_names} {-contro1_arg} 

FUNCTION 

establishes a list of meetings to be checked when changed. The user is notified when the 
meeting is changed. The meetings can be successfully viewed with the next_meeting (nm) 
request. 

ARGUMENTS 

meeting_names 

are names of meetings to be checked. The star convention is allowed. If meeting_names 
are given, the list of changed meetings will consist of any changed meetings in the list 
given. If no meeting_names are given, information for all meetings found in the forum 
search path are printed. 

CONTROL ARGUMENTS 

-list, -Is 

prints the name of each changed meeting and the number of new transactions in each. 
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eurrent^meeting delete 



Name* current meeting, cmtg 

SYNTAX 

cmtg {-control_args} 

SYNTAX AS AN ACTIVE REQUEST 

[cmtg {-control_args}] 

FUNCTION 

prints or returns the entry name or pathname of the meeting that the user is currently 
attending 

CONTROL ARGUMENTS 

-absolute_pathname, -absp 

prints or returns the full pathname of the meeting. 

-entry, -et 

prints or returns only the entry name portion of the pathname of the current meeting. 
(Default) 



Name: delete, dl 

SYNTAX 

dl trans_specs 

FUNCTION 

Allows participants to logically remove specified transactions from a meeting. The chairman 
of a meeting can delete any transaction, and a participant can delete any transaction that 
he/she submitted. These transactions can then be physically removed from the meeting by the 
chairman with the "expunge" request 

ARGUMENTS 

trans_specs 

are transaction specifiers that determine which transactions are deleted (see below). See 
Section 3 for complete information on transaction specifiers. At least one transaction 
must be specified with this request. 



'-AO CY/4-U2 



delete delete 



LIST OF TRANSACT/ON SPECIFICATION CONTROL ARGUMENTS 

-after DT, -af DT 

selects transactions entered on or after the the date specified. The time of day is 
ignored. 

-after_time DT, -aft DT 

selects transactions entered after the date_time specified. 

-before DT, -be DT 

selects transactions entered before the date specified. The time of day is ignored, 

-before_time DT, -bet DT 

selects transactions entered before the date_time specified. 

-between DTI DT2, -bt DTI DT2 

selects transactions entered between the dates specified, inclusive. The times of day are 
ignored. 

-between_time DTI DT2, -btt DTI DT2 

selects transactions entered between the date_times specified, inclusive. 

-date DT, -dt DT 

selects transactions entered on the day specified. 

-from Person_id, -fm Person_id 

selects transactions entered by the participant named Personjd. 

-subject /REGEXP/, -sj /REGEXP/ 

selects transactions whose subject matches toe given regular expression. 

-text /REGEXP/, -tx /REGEXP/ 

selects transactions whose text matches the given regular expression. 

NOTES 

Deleted transactions are ignored by all requests that process transactions. Deleted transactions 
can be restored by using the "retrieve" request 
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delete_participant do 



Name delete oarticitiant. dint 

SYNTAX 

dipt Person_ids {-control_args} 

FUNCTION 

logically removes the record of participation (attendee record) of a participant in a meeting. 
Once removed, these attendee records can be deleted with the "expunge" request Only the 
chairman of the meeting can issue either request. 

ARGUMENTS 

Person_ids 

are the name(s) of the participants whose records are to be deleted. 

CONTROL ARGUMENTS 

-brief, -bf 

suppresses the message "Specified switch was not changed." 

-long, -lg 

prints the message "Specified switch was not changed." if the record for that participant 
has already been deleted. (Default) 

NOTES 

Deleted participants are ignored by all requests that list participants. Deleted participants can 
be restored by using the "retrieve_participant" request 



Name: do 

SYNTAX 

do request_str ing {args} 
or: do -control_args 

SYNTAX AS AN ACTIVE REQUEST 

[do "request_string" args] 

FUNCTION 

expands a request line by substituting the supplied arguments into the line before execution. 
As an active request, returns the expanded request_string rather than executing it. 
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do do 



ARGUMENTS 

request_string 

is a Forum request line enclosed in quotes. 

args 

are character string arguments that replace parameters in request.string. 

CONTROL ARGUMENTS 

These control arguments set the mode of operation of the do request 

-absentee 

establishes an any_other handler that catches all conditions and aborts execution of the 
request line without aborting the process. 

-brief, -bf 

does not print the expanded request line before execution. (Default) 

-go 

passes on the expanded request line for execution. (Default) 

-interactive 

does not establish the any_other handler. (Default) 

-long, -Ig 

prints the expanded request line before execution. 

-nogo 

does not pass on the expanded request line for execution. 

LIST OF PARAMETERS 

Any sequence beginning with & in the request line is expanded by the do request using the 
arguments given on the request line. 

&1 ... &9 are replaced by the first through 9th arguments respectively. 

&(N) is replaced by argN where N is any integer. 

&ql ... &q9 is replaced by the first through 9th arguments with any quotes doubled. 

&q(N) is replaced by argN with any quotes doubled. N can be any integer. 

&rfl ... &rf9 is replaced by the first through 9th arguments surrounded by a level of quotes 
with any contained quotes doubled. 

&r(N) is replaced by a requoted argN. I can be any integer. 

&fN is replaced by all the arguments starting with argN where N must be a digit 

from 1 to 9. 
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do 



enter 



&f(N) is replaced by all the arguments starting with argN where N can be any 

integer. 

&qfN is replaced by all the arguments starting with argN with any quotes doubled. N 

must be a digit from 1 to 9. 

&qf(N) is replaced by all the arguments starting with argN with quotes doubled where 

N can be any integer. 

&rN is replaced by all the arguments starting with argN. Each argument is placed 

in a level of quotes with contained quotes doubled. N must be a digit from 1 
to 9. 

&rf(N) is replaced by all the arguments starting with argN, requoted. N can be any 

value. 

&& is replaced by an ampersand. 

&! is replaced by a 15 character unique string The string used is the same 

everywhere & appears in the request line. 

&n is replaced by the actual number of arguments supplied. 

&f&n is replaced by the last argument supplied. 



Name: enter, en, send 

SYNTAX 

en {-control_args} 

FUNCTION 

enters an unprocessed transaction, that was created either by escaping to the Forum request 
loop via "talk" mode or by using the "qedx" or "ted" requests. 

CONTROL ARGUMENTS 

-brief, -bf 

suppresses the message indicating the transaction was entered. 

-long, -lg 

prints a message indicating that the transaction was successfully entered. (Default) 



7-?n 



enter exec_.com 



-meeting meeting_name, -mtg meeting_name 

enters the transaction into the proceedings of the meeting_name meeting. The default is 
to enteT the transaction into the meeting that the user was attending when the transaction 
was created. Meeting_name can be the name or pathname of a meeting. This control 
argument cannot be used if the transaction was built using the "reply" request 



Name: exec com, ec 

SYNTAX 

ec ec_path {ec_args} 

SYNTAX AS AN ACTIVE REQUEST 

[ec ec_path {ec_args}] 

FUNCTION 

executes a exec_com segment containing forum requests. As an active request, it returns a 
value passed from the exec_com segment with the &return statement 

ARGUMENTS 

i 
ec_paths 

is the pathname of an exec_.com program. The ".fmec" suffix is assumed if not 

specified. 

ec_args 

are optional arguments to the exec_.com program and are substituted for parameter 
references in the program. 

NOTES 

Forum searches the "exec_com" search list for ec_paths with the ".fmec" suffix unless an 
absolute pathname is given. 

For a description of the exec_com language (both version 1 and version 2), see the 
Commands manual. 

When evaluating a subsystem exec_.com program, Forum active requests are used rather than 
Multics active functions when evaluating the &[...] construct and the active string in an &if 
statement The subsystem's execute active request must be used to evaluate Multics active 
strings within the exec_com. 
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execute expunge 

Name: execute, e 

SYNTAX 

e LINE 

SYNTAX AS AN ACTIVE REQUEST 

[e LINE] 

FUNCTION 

executes the supplied line as a Multics command line. As an active request, evaluates a 
Multics active string and returns the result to the Forum request processor. 

ARGUMENTS 

LINE 

is the Multics command line to be executed or the Multics active string to be evaluated. 
It need not be enclosed in quotes. 

NOTES 

The recommended method to execute a Multics command line from within Forum is the ".." 
escape sequence which does not expand Forum active requests in the line before passing it to 
the command processor. The "execute" request is intended as a means of passing information 
from Forum to the Multics command processor. 

All unquoted (), [], and " characters in the given line are processed by the Forum request 
processor and not the Multics command processor. This fact permits the passing of the values 
of Forum active requests to Multics commands when using the "execute" request or, when 
using the "execute" active request, to Multics active functions for further manipulation before 
returning the values to the Forum request processor for use within a request line. 



Name: expunge 

SYNTAX 

expunge {-control_args} 

FUNCTION 



physically removes deleted participant records and transactions from a meeting and frees their 
storage. This request also checks the consistency of the control segment and attempts to 
salvage invalid transaction and attendee records (see "Notes" below). Only the chairman of the 
meeting can issue this request. 
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expunge fill 



CONTROL ARGUMENTS 

-brief, -bf 

suppresses the messages indicating how many participants and transactions were expunged. 

-force, -fc 

does not ask if the user really wants to expunge the meeting. 

-long, -lg 

prints messages indicating how many participants and transactions were expunged. 
(Default) 

-participants, -part 

expunges only attendee records. The default expunges both attendee records and 
transactions. 

-transactions, -trans 

expunges only transactions. The default expunges both attendee records and transactions. 

NOTES 

A user's attendee record is his record of participation in the meeting, which displays his 
User_id, last time attended, and last transaction seen. Attendee records are printed by the 
"list_users" request 



Name: fill, fi 

SYNTAX 

fi {-control_args} 

FUNCTION 

reformats the text of the unprocessed transaction to fit within a given line length. It is also 
used to control whether or not the transaction is filled after it is entered. 

CONTROL ARGUMENTS 

-iine_length N, -11 N 

is the width to be used when reformatting the text (Default — either the value specified 
by the -line_length argument to the forum command or 72 if this argument was not 
given). The line length given must be between 10 and 136. 

-off 

does not fill this transaction by default when printed or written. 

-on 

fills this transaction by default when printed or written. 
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forum_dir „_ 

goto 



Name forum__dir, fd 

SYNTAX 
fd 

SYNTAX AS AN ACTIVE REQUEST 

[fd] 

FUNCTION 

prints/returns the absolute pathname of the central forum directory. 
NOTES 

pie central forum directory is the location for site-approved public meetings. This directory 
is included in the default forum search path. The forum request 

! e add_search_paths forum [forum_dir] 

can be used to add the central directory to the forum search path. See Section 3 for more 
information on search paths. 



Name: goto, go, g 

SYNTAX 

g {meet i ng_name} {-contro!_arg} 

FUNCTION 

enters a meeting or switches from one meeting to another. This request requires access to the 
meeting_name meeting. 

ARGUMENTS 

meeting_name 

is the pathname or entryname of an established meeting. If a pathname is specified it 
identifies the meeting directly. Otherwise, the forum search list will be used in' an 
attempt to locate the meeting. The ".control" suffix is optional. Either this argument or 
the -meeting" control argument must be given. 

CONTROL ARGUMENTS 

-meeting meeting_name, -mtg meeting_name 

enters the meeting whose pathname or entryname is meeting_name. See the description of 
the meeting_name argument above. 
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g° to help 



-no_return_on_error, -nroe 

does not return to the current meeting if meeting_name does not exist or cannot be 
accessed for any other reason (this is the default). 

-return_on_error, -roe 

returns to the current meeting if the new meeting cannot be accessed. 



Name: help 

SYNTAX 

help {topics} {~contro1_args} 

FUNCTION 

prints information about various Forum topics including detailed descriptions of Forum 
requests. 

ARGUMENTS 

topics 

are the topics on which information is to be printed. The topics available within Forum 
can be determined by using the "list_help" request (see "listjielp" below). 

CONTROL ARGUMENTS 

The following specify information selection. All but -all and -brief leave you in help's 
request loop after they have printed their specific information. 

-all, -a 

prints the entire info without intervening questions. 

-brief, -bf 

r txx^u> x*»iij u oiuuumu; v>i a 1&14UW01 ui active icqucai, uikiuumg uic syntax section, iisi oi 
arguments, control arguments, etc. 

-brief_header, -bfhe 

prints a brief heading with the info. 

-control_arg STR, -ca STR 

prints the descriptions of control (or other) arguments containing the string STR. 

-header, -he 

prints only the heading line. 

-search STRs, -srh STRs 

begins printing with the paragraph containing all the strings STRs. By default, printing 
begins at the top of the information. 



7-25 CY74-02 



help help 



begins printing at the section whose title contains all the strings STRs. By default, 
printing begins at the top of the information. 

-title 

prints section titles and section line counts, then asks if the user wants to see the first 
paragraph of information. 

UST OF RESPONSES 

1 

prints the list of responses allowed to help queries. 

identifies the current Forum environment 

.. command_line 

treats the remainder of the response as a Multics command line. 

brief, bf 

prints a brief summary, including the Syntax section and a list of arguments, then repeats 
the previous question. 

control_arg STR, ca STR 

prints the descriptions of control (or other) arguments whose names contain STR. 

header, he 

prints a long heading line consisting of the pathname of the info seg, heading, and line 
count 

no, n 

stops printing information for this topic and proceeds to the next topic, if any. 

quit, q 

stops printing information for this topic and returns to the Forum's request level. 

rest {-sen}, r {-sen} 

prints remaining information for this topic without intervening questions. If -section or 
-sen is given, "help" prints only the rest of the current section without questions and 
then asks if the user wants to see the next section. 

search {STRs} {-top}, srh {STRs} {-top} 

skips to the next paragraph containing all the strings STRs. If -top or -t is given, 
searching starts at top of the information. If STRs are omitted, "help" uses the STRs 
from the previous search response or the -search control argument. 

section {STRs} {-top}, sen {STRs} {-top} 

skips to the next section whose title contains all the strings STRs. If -top or -t is 
given, title searching starts at the top of the information. If STRs are omitted, "help" 
uses the STRs from the previous section response or the -section control argument 



help 



skip {-sen | -seen} , s {-sen \ -seen} 

skips to the next paragraph. If -section or -sen is given, skips all paragraphs of the 
current section. If -seen is given, skips to the next paragraph that the user has not seen. 
Only one control argument is allowed in each skip response. 

title {-top} 

lists titles and line counts of the sections that follow; if -top or -t is given, "help" lists 
all section titles, "help" then repeats the previous question after titles are printed. 

top, t 

skips to the beginning of the info seg, prints the heading line, and asks whether the user 
wants to see the first section. 

yes, y 

prints the next paragraph of information on this topic. 

NOTES 

If given no topic names, the "help" request explains what requests are available to obtain 
information about Forum. 

For a more complete description of the control arguments and responses accepted by this 
request, see the help command in the Commands manual. 



Name: if 

SYNTAX 

if EXPR -then LINE1 {-else LINE2} 

SYNTAX AS AN ACTIVE REQUEST 

[if EXPR -then STR1 {-else STR2}] 

FUNCTION 

conditionally executes one of two request lines depending on the value of an active string. As 
an active request, returns one of two character strings to the Forum request processor 
depending on the value of an active string. 

ARGUMENTS 

EXPR 

is the active string that must evaluate to either "true" or "false". The active string is 
constructed from Forum active requests and Multics active strings (using the Forum's 
execute active request). 
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if list 



LINE1 

is the Forum request line to execute if EXPR evaluates to "true". If the request line 
contains any request processor characters, it must be enclosed in quotes. 

STR1 

is returned as the value of the if active request if the EXPR evaluates to "true". 

LINE2 

is the Forum request line to execute if EXPR evaluates to "false". If omitted and EXPR 
is "false", no additional request line is executed. If the request line contains any request 
processor characters, it must be enclosed in quotes. 

STR2 

is returned as the value of the if active request if the EXPR evaluates to "false" If 
omitted and the EXPR is "false", a null string is returned. 



Name: list, Is 

SYNTAX 

Is {trans_specs} {-control_args} 

SYNTAX AS AN ACTIVE REQUEST 

[is {trans_specs} {-control_args}] 

FUNCTION 

prints the transaction number, author, subject, and date/ time of specified transactions on the 
user's terminal. As an active request, returns a list of numbers of selected transactions. 

ARGUMENTS 

trans_specs 

are transaction specifiers that determine the transactions to be listed. See "List of 
transaction specification control arguments" below. See Section 3 for complete information 
on transaction specifiers. If no transaction specifiers are supplied, all transactions are 
listed. 

CONTROL ARGUMENTS 

-brief, -bf 

prints a brief summary line for each transaction selected. 

-by_chain 

specifies that transactions are to be grouped by transaction chain. 
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list list 



-fill, -fi 

fills listed transactions in order to obtain the line count Not valid if invoked as an 
active request 

-header, -he 

prints the header. (Default) 

-include_deleted, -idl 

lists transactions even if they have been deleted. See "Notes" below. Default is 
-only_non_deleted. 

-inhibit_error, -ihe 

does not print an error if no transactions are selected. Only valid if invoked as an 
active request 

-initial 

lists only the transactions that are at the beginning of transaction chains. 

-long, -lg 

prints a complete summary of the transaction. (Default) 

-long_subject, -lgsj 

inhibits truncation of summary lines. The subject of the transaction will extend to the 
next line if it is longer than the terminal width. 

-meeting meeting_name, -mtg meeting_name 

selects the specified transactions from the meeting_name meeting. The default selects 
transactions from the current meeting. 

-no_fill, -nfi 

suppresses filling of transactions in order to obtain the line count Not valid if invoked 
as an active request (Default) 

-no_header, -nhe 

suppresses printing of the header. Not valid if invoked as an active request. 

-no_inhibit_error, -nine 

prints an error if no transactions are selected. Only valid if invoked as an active 
request (Default) 

-no_update, -nud 

causes the list request to not update the current transaction index. Not valid if invoked 
as an active request 

-only_deleted, -odl 

lists only deleted transactions. See "Notes" below. Default is -only_non_deleted. 

-only_non_deleted, -ondl 

lists only non-deleted transactions. (Default) 
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list list 



-output_file PATH, -of PATH 

directs the output of the list request to the file named by PATH. Not valid if invoked 
as an active request 

-reverse, -rv 

lists transactions in the reverse order of that specified. 

-update, -ud 

sets the current transaction index to the index of the first transaction listed unless the 
current transaction is among those listed. Not valid if invoiced as active request 
(Default) 

LIST OF TRANSACT/ON SPECIFICATION CONTROL ARGUMENTS 

-after DT, -af DT 

selects transactions entered on or after the the date specified. The time of day is 
ignored. 

-after_time DT, -aft DT 

selects transactions entered after the date_time specified. 

-before DT, -be DT 

selects transactions entered before the date specified. The time of day is ignored. 

-before_time DT, -bet DT 

selects transactions entered before the date_time specified. 

-between DTI DT2, -bt DTI DT2 

selects transactions entered between the dates specified, inclusive. The times of day are 
ignored. 

-between_time DTI DT2, -btt DTI DT2 

selects transactions entered between the date_times specified, inclusive. 

-date DT, -dt DT 

selects transactions entered on the day specified. 

-from Person_id, -fm Person_id 

selects transactions entered by the participant named Person_id. 

-subject /REGEXP/, -sj /REGEXP/ 

selects tra n sa c t ion s whose subject matches the given regular expression. 

-text /REGEXP/, -tx /REGEXP/ 

selects transactions whose text matches the given regular expression. 

NOTES 

In order to list a deleted transaction, the user must either be the chairman of the meeting or 
the author of the deleted transaction. 
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listjielp list_meetings 

Name: list_help, Ih 

SYNTAX 

lh {topics} 

FUNCTION 

displays the names of all Forum info (help) segments pertaining to a given set of topics. 

ARGUMENTS 

topics 

specifies the topics of interest. Any Forum info segment that contains one of these 
topics is listed. 

NOTES 

If no topics are given, all info segments available for Forum are listed. 

When matching topics with info segment names, an info segment name is considered to match 
a topic only if that topic is at the beginning or end of a word within the segment name. 
Words in info segment names are bounded by the beginning and end of the segment name 
and by the characters period (.), hyphen (-), underscore (_). and dollar sign ($), The ".info" 
suffix is not considered when matching topics. 

EXAMPLES 

! 1 ist_help ex 

matches info segments named expunge, execute, trans_specs_ex, and exec_com but does not 
match an info segment named nextref. 



Name: list meetings, Ism 

SYNTAX 

Ism {meeting = names} {-control_args} 

SYNTAX AS AN ACTIVE REQUEST 

[Ism {-control_args}] 

FUNCTION 

prints a list of selected meetings on the user's terminal. For each meeting selected, 
information about the names of the meeting and per-user meeting attributes are listed. 
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list.meetings list.meetings 



ARGUMENlS 

meeting_names 

are optional meeting_names. If any are supplied, information about only the specified 
meeting_names is printed. The star convention is supported for meeting_names. If no 
meeting_names are given, information for all meetings found in the forum search path 
are printed. 

CONTROL ARGUMENTS 

-absolute_pathname, -absp 

prints the absolute pathname of a meeting. The default lists the long and short meeting 
names only. 

-adjourned, -adj 

selects information about meetings that have been adjourned. 

-all, -a 

prints information about all meetings. The default prints information about the meetings 
in which the user is eligible to participate only. 

-brief, -bf 

suppresses the message "No meetings have changed", which is printed by default if the 
-changes control argument is used and no meetings have changed. 

-chairman {Person_id}, -cm {Person_id} 

prints information about meetings of which Person_id is chairman. If Person_id is not 
given, the user's Person_id is used. 

-changed, -chg 

prints information about meetings in which the user is a participant and in which new 
transactions have been entered. 

-count, -ct 

prints out the number of new transactions for a meeting in which the user is 
participating. This control argument cannot be used if list meetings is invoked as an 
active request 

-eligible, -elig 

prints information about all meetings in which the user is eligible to participate 
(Default) 

-exclude meeting_names, -ex meeting_names 

excludes the meetings identified by meeting_names from the output list The meeting_names 
argument can be a starname. The default (-include) is to select all meetings that match 
the specified starname. 

-from DT, -fm DT 

selects meetings that have changed since the specified time. DT is any string acceptable 
to the convert_date_to_binary_ subroutine. The default is the current date-time. 
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list_meetings list_meetings 



-header, -he 

prints the header. This is the default, unless the -changes control argument is given. 

-include meeting_names, -incl meeting_names 

includes the meetings identified by meeting_names in the output list The meeting_names 
argument can be a starname. (Default) 

-inhibit_error, -ihe 

does not print warning messages for such things as bad meeting format and errors 
encountered while searching for meetings. (Default) 

-long, -lg 

prints the message "No meetings have changed" if the -changes control argument is used 
and no meetings in which the user is a participant have changed. (Default) 

-no_adjourned, -nadj 

specifies that adjourned meetings are not to be listed. 

-no_changes, -nchg 

does not list changed meetings. 

-no_header, -nhe 

suppresses printing of the header. 

-no_inhibit_error, -nihe 

prints ail warning messages. 

-no_notify, -nnt 

does not list meetings in which the user has the notify flag set. 

-no_participating, -npart 

does not list meetings in which the user is a participant 

-no_read_only, -nro 

does not list mee-tin** to which the user has onl v read access. 

-notify, -nt 

lists only meetings in which the user has the notify flag set 

-participating, -part 

lists only meetings in which the user is participating. The default prints information 
about all meetings in which the user is eligible to participate. 

-read_only, -to 

lists just meetings to which the user has only read access. 

-user User_id 

determines participation, changes, and eligibility attributes for the user specfied by 
User_id. User_id is in the form Person_id.Project_id.tag, where any of the components 
can be the character "*". If a component is omitted, it is assumed to be "*". 
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-verbose, — vb 

prints the chairman's User_id and current and last transactions for each meeting. Cannot 
be used with -changes or when Ism is being invoked as an active request 

NOTES ON FLAGS 

The output from this command can include flags that have the following interpretation: 

a attending flag: Indicates that the user is currently attending the meeting. 

e eligible flag: indicates that the user can participate in the meeting. 

p participant flag: indicates that the user is a participant in the meeting (i.e., has 

"gone to" the meeting at least once). 

r removed flag: indicates that the user has removed himself from participation in 

the meeting. 

n notify flag: indicates that the user has turned on the notify flag in the 

meeting (i.e., that the user has requested online notification when new 
transactions are entered in the meeting). 

c change flag: indicates that new transactions have been entered in the 

proceedings of the meeting since the user last attended this meeting. 

o observer flag: indicates that the user has only read access to the meeting. 

j adjourned flag: indicates that the chairman has temporarily adjourned the 

meeting. 

Note that the flags corresponding to the selection criteria are not shown (i.e., if the user is 
selecting meetings to which he or she is eligible, the "e" flag is not printed). 



Name: list requests, lr 

SYNTAX 

lr {STRs} {-control_args} 

FUNCTION 

prints a brief description of selected Forum requests. 
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list_requests jjst users 



ARGUMENTS 

STRs 

specifies the requests to be listed. Any request with a name containing one of these 
strings is listed unless -exact is used, in which case the request name must exactly match 
one of these strings, 

CONTROL ARGUMENTS 

-all, -a 

includes undocumented and unimplemented requests in the list of requests eligible for 
matching the STR arguments. 

-exact 

lists only those requests whose names exactly match one of the STR arguments. 

NOTES 

If no STRs are given, all requests are listed. 

When matching STRs with request names, a request name is considered to match a STR only 
if that STR is at the beginning or end of a word within the request name. Words in request 
names are bounded by the beginning and end of the request name and by the characters 
period (.), hyphen (-), underscore (_), and dollar sign ($). 

EXAMPLES 

! 1 ist_requests ex 

matches requests named execute and exec_com but does not match a request named nextref. 
You have to specify -all to get the expunge request listed, unless you are the chairman of 
the meeting you are currently attending. 



Name: list users, lsu 

SYNTAX 

lsu {-control_args} 

SYNTAX AS AN ACTIVE REQUEST 

[lsu {-control_args}] 

FUNCTION 

prints a list of selected participants of a meeting. For each participant selected, the 
Person_id, Projected, current transaction number (last one seen), the date/time last attended, 
and several flags are listed. The active request returns a list of Person_ids. 
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CONTROL ARGUMENTS 

-after TIME, -af TIME 

lists only those participants who have attended since the given time. 

-all, -a 

lists all participants, including those who are not participating in the meeting. 

-ascending, -asc 

sort in ascending order. This is the default for sorting by name. This may not be used 
if invoiced as an active request 

-attending, -at 

lists only participants who are currently attending this meeting. 

-before TIME, -be TIME 

lists only those participants who have not attended since the given time. 

-brief, -bf 

suppresses the message "No participants were selected." 

-descending, -dsc 

sort in descending order This is the default for sorting by time last attended. This 
control argument cannot be used if list_users is invoked as an active request 

-eligible, -elig 

prints a list of users and projects that are eligible to attend the meeting. Read-only 
eligibility is denoted by an asterisk (*). This control argument cannot be used if 
list_users is invoked as an active request This control argument cannot be combined with 
any other control argument 

-header, -he 

prints the header. This control argument cannot be used if list_users is invoked as an 
active request (Default) 

-long, -lg 

prints the message "No participants were selected." if this is the case. (Default) 

-meeting meeting_name, -mtg meeting_name 

lists participants of the meeting_name meeting. The default lists participants of the 
current meeting. 

-names_only 

only prints the names of the selected participants. This control argument is not valid if 
names_only is invoked as an active request 

-no_header, -nhe 

suppresses printing of the name_list header. 

-no_participating, -npart 

lists only those users who are no longer participating. 
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list_users list_users 



-no_read_only, -nro 

does not list read-only participants. 

-notify, -nt 

lists only participants who have the notify flag set 

-only_deleted, -odl 

lists only information for participants who have been deleted by the chairman. 

-only_non_deleted, -ondl 

lists only information for participants who have not been deleted by the chairman. 
(Default) 

-participating, -part 

lists only users who are participating. (Default) 

-project Project_ids, -pj Project_ids 

lists only information about participants on the specified project All arguments following 
-project until the next control argument are taken as Project_ids. 

-read_only, -ro 

lists just the read-only participants. 

-seen transaction_number 

lists only the participants who have read the specified transaction. 

-sort TYPE 

sorts the output by TYPE. TYPE is either "name" for sorting by the Person_id of 
participants, or "date_time^attended" (dta) for sorting by the time the participant last 
attended the meeting. This control argument cannot be used if list_users is invoked as an 
active request 

-totals, -tt 

prints only the total number of participants selected. 

-unseen transaction_number 

lists only participants who have not read the specified transaction. 

-user Person_ids 

lists only information about the named participants. All arguments following -user until 
the next control argument are taken as Person_ids. 

NOTES 

The displayed flags have the following meanings: "d" indicates that the chairman has deleted 
that participant, "r" indicates that the participant has been removed from the meeting and is 
therefore no longer a participant "n" means that the user has the "notify flag" turned on, 
and "o" means that the user is an observer and cannot enter transactions. 
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mail mail 

Name mall 

SYNTAX 

mail {trans_specs} {-control_args} 

FUNCTION 

sends a transaction or set of transactions to other users, mailing lists, or Forum meetings 
using the Multics mail system. 

ARGUMENTS 

trans_specs 

are transaction specifiers which determine the transactions to be mailed. See Section 3 
for more information on transaction specifiers. If no transaction specifiers are supplied, 
the unprocessed transaction is mailed if there is one, otherwise the current transaction is 
mailed. If more than one transaction is specified, each one is sent as a separate piece of 
mail. 

CONTROL ARGUMENTS 

-acknowledge, -ack 

requests an acknowledging message from the recipients when they read the mail 

-bcc addresses 

specifies recipients who will receive blind carbon copies of the mail. Either -bcc 
addresses, -cc addresses, or -to addresses is required. 

-brief, -bf 

suppresses messages informing the user of successful mail delivery. 

-cc addresses 

specifies recipients who will receive carbon copies of the mail. Either -bcc addresses, -cc 
addresses, ot -to addresses is required. 

-fill, -fi 

specifies that the transactions should be filled before being mailed. 

-linejength LEN, -11 LEN 

specifies the line length to be used for filling If this control argument is given, -fill 
need not be. 

-long, -lg 

prints messages informing the user of successful mail delivery. (Default) 

-no_acknowledge, -nack 

does not request acknowledging messages from the recipients. (Default) 

-no_fill, -nfi 

does not fill the transactions before mailing them. (Default) 
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-reply_to addresses 

specifies the return address which will appear in the Reply-To field of the mail. Either 
-bcc addresses, -cc addresses, or -to addresses is required. 

-subject STR -sj STR 

sets the subject of the mail to be STR The default subject is the subject of the 
transaction being mailed. 

-to addresses 

specifies the primary recipients of the mail. This control argument is required. 

NOTES 

The mail contains two header fields identifying it as having been sent by forum. These fields 
are: 

Forum-Transaction: [NNNN] in the MEETING_PATH meeting. 
Transaction-Entered-By: AUTHOR 
Transact ion-En tered-Date: DATE_TIME 

See the Multics Extended Mail System User's Guide, Order No. CH23, for information on 
the valid syntax for mail addresses. 



Name: make_public, mp 

SYNTAX 

mp {-control_args} 

FUNCTION 

opens the current meeting to public participation. You can use this request if you have either 
modify permission on the containing directory or chairman access to the meeting. 

CONTROL ARGUMENTS 

-chairman, -cm 

gives access (c) to the added participant This control argument is not valid for meetings 
created with pre-MRll software. 

-read_only, -ro 

allows the public to read transactions but not to enter them. 

NOTES 

The -read_only and -chairman control arguments cannot both be specified. For information 
on converting a meeting, refer to "Duties of the Chairman" later in this manual. 
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Name: next_meeting, nm 

SYNTAX 

nm {-control_arg} 

SYNTAX AS AN ACTIVE REQUEST 

[nm {-control_arg}] 

FUNCTION 

changes the current meeting to the next meeting in the list of changed meetings established 
by the check_meetings request As an active function, it returns the name of the next 
meeting on the list In either case, that meeting is removed from the list 

CONTROL ARGUMENTS 

-all, -a 

prints or returns a list of all of the meetings in the list of changed meetings, including 
those already checked by this request If this control argument is used, neither the 
current meeting nor the list will be changed. 

-list -Is 

prints or returns a list of the remaining meetings in the list of changed meetings. If this 
control argument is used, neither the current meeting nor the list will be changed. 

NOTES 

The check_meetings request must have already been used in this process. This request calls 
the request processor with the request line: 

goto MEETING_NAME 
so a user-defined abbreviation for the goto request will be expanded. 

When -all or -list is used, the count of new transactions displayed is the number of 
transactions that were new when the check_meetings request was invoked. 
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Name: print, pr, p 

SYNTAX 

p {trans_specs} {-contro1_args} 

FUNCTION 

prints specified transactions on the terminal. 

ARGUMENTS 

trans_specs 

are transaction specifiers that determine the transactions to be printed. See "List of 
transaction specification control arguments" below. See Section 3 for complete information 
on transaction specifiers. If no transaction specifiers are supplied, the unprocessed 
transaction is printed (if there is one), otherwise the current transaction is printed. 

CONTROL ARGUMENTS 

-by_chain 

specifies that transactions are to be grouped by transaction chain. 

-fill, -fi 

fills transactions before printing them. 

-include_deleted, -idl 

selects transactions even if they have been deleted. See "Notes" below. Default is 
-only_non_deleted. 

-initial 

selects only transactions that begin transaction chains. 

-meeting meeting_name, -mtg meeting_name 

selects the specified transactions from the meeting_name meeting The default selects 
transactions from the current meeting. 

-no_fill, -nfi 

suppresses filling of transactions. (Default) 

-only_deleted, -odl 

selects only deleted transactions. See "Notes" below. Default is -only_non_deleted. 

-only_non_deleted, -ondl 

selects only non-deleted transactions. (Default) 

-reverse, -rv 

prints transactions in the reverse order of that given in the transaction specifier. 
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LIST OF TRANSACTION SPECIFICATION CONTROL ARGUMENTS 

-after DT, -af DT 

selects transactions entered on or after the date specified. The time of day is ignored. 

-after_time DT, -aft DT 

selects transactions entered after the date_time specified. 

-before DT, -be DT 

selects transactions entered before the date specified. The time of day is ignored. 

-before_time DT, -bet DT 

selects transactions entered before the date_time specified. 

-between DTI DT2, -bt DTI DT2 

selects transactions entered between the dates specified, inclusive. The times of day are 
ignored. 

-between_time DTI DT2, -btt DTI DT2 

selects transactions entered between the date_times specified, inclusive. 

-date DT, -dt DT 

selects transactions entered on the day specified. 

-from Person_id, -fm Person_id 

selects transactions entered by the participant named Person_id. 

-linejength LENGTH, -11 LENGTH 

fills the transaction to the specified line length. The default is 72 columns unless a 
different value was given with the -output_line_length or -linejength control argument 
to the forum command. 

-subject /REGEXP/, -sj /REGEXP/ 

selects transactions whose subject matches the given regular expression. 

-text /REGEXP/, -tx /REGEXP/ 

selects transactions whose text matches the given regular expression. 

NOTES 

In order to print a deleted transaction, the user must be either the chairman of the meeting 
or the author of the deleted transaction. 
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Name: qedx, qx 

SYNTAX 

qx {-control_arg} 

FUNCTION 

invokes the Qedx editor to edit the text of the unprocessed transaction or to build a new 
transaction. See the Qedx Text Editor User's Guide, Order No. CG40, for more 
information on the Qedx editor. 

CONTROL ARGUMENTS 

-auto_write 

specifies that the "w" request is not required in order to save editing changes. See 
"Notes". 

-fill, -fi 

specifies that the transaction is to be refilled upon exit from the editor. This is the 
default unless the -no_input_fill control argument was given to the forum command or 
unless the -no_fill control argument was given to the talk or reply request 

specifies that the "w" request is required in order to save editing changes. (Default) 

-no_fill, -nfi 

specifies that the transaction is not to be refilled upon exit from the editor. (Default) 

NOTES 

The transaction text is placed in a buffer . The write (w) request must be used to save any 
changes unless -auto_write is given. If -auto_write is given, the contents of the buffer always 
replaces the transaction when the editor is exited. The write request can be used as often as 
desired to checkpoint the editing process. 

If the quit (q) request is issued, -auto_write was not specified, and the transaction has been 
modified since it was last written, qedx will query for permission to exit If permission is 
given, any changes made since the last write request (if any) will be lost. The quit-force (qf) 
request can be used to abort unwanted editing without being queried. 

The read (r) and write (w) requests still accept pathnames and may be used to insert a 
segment into the transaction or make a copy in a segment for later use, respectively. 
However, when used with a pathname, these requests will not change the default pathname 
for the buffer (the transaction). Using either read or write without a pathname will always 
refer to forum's copy of the transaction. 
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If issued before use of the write request, the request line: 
! l,$dr 

will restore the original transaction text to the buffer. If given after a write request, this 
request line will restore the transaction as saved by the last write request given in the buffer. 

For information on converting a meeting, refer to "Duties of the Chairman'' later in this 
manual. 



Name: quit, q 

SYNTAX 

q {-control_arg} 

FUNCTION 

exits the Forum subsystem. 

CONTROL ARGUMENTS 

-force, -fc 

does not ask if the user really wants to quit if there is an unprocessed transaction. 



Name: remove meeting, rm 

SYNTAX 

rm {meet i ng_names} {-control_args} 

FUNCTION 

removes meetings in the user's forum search list by deleting links to them from the directory 
>udd>Project>Person>meetings. 

ARGUMENTS 

meeting_names 

are names of forum meetings to be removed from the search list The star convention is 
allowed. 
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CONTROL ARGUMENTS 

-check, -ck 

lists all links to meeting in >udd>Project>Person>meetings that point to non-existent 
meetings. Incompatible with -cleanup. 

-cleanup 

removes all links to forum meetings from >udd>Project>Person>meetings that point to 
non-existent meetings. Incompatible with -check. 

-directory PATH, -dr PATH 

removes the links from the specified directory instead of the default directory of 
>udd>Project>Person>meetings. 

NOTES 

If a meeting is found through some other entry in the forum search list, the site's central 
forum directory for instance, this command can not remove it 



Name: remove_participant, rpt 

SYNTAX 

rpt Person_id 

FUNCTION 

makes the person identified by Person_id ineligible to participate in the current meeting. You 
can use this request if you have either modify permission on the containing directory or 
chairman access to the meeting. 

ARGUMENTS 

Person_id 

is the Person_id of the user to be removed from participation in the meeting. 

NOTES 

For information on converting a meeting, refer to "Duties of the Chairman" later in this 
manual. 
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remove_project 

Name remove project, rpj 

SYNTAX 

r PJ Project_id 

FUNCTION 

makes all participants who are currently eligible because of their Projected, not because of 
their Person_id, ineligible to attend the current meeting. You can use this request if you 
have either modify permission on the containing directory or chairman access to the meeting. 

ARGUMENTS 

Projected 

is the Project_id of the project whose members are to be removed from participation if 
they lack explicit Person_id participation rights. 

NOTES 

For information on converting a meeting, refer to "Duties of the Chairman" later in this 
manual. 



Name: reply, rp 

SYNTAX 

rp {transact ion_specif ier} {-controi_args} 

FUNCTION 

allows a participant to build, and optionally enter into the proceedings of a meeting, a 
transaction that is in reply to an earlier transaction and thus perpetuate a "chain" of 
transactions. 

ARGUMENTS 

transaction_specifier 

is the transaction specifier of the transaction to be replied to. If this argument is not 
given, the current transaction is replied to. Transaction specifier must name only one 
transaction and therefore cannot include a User_id, regular expression, or range. 

CONTROL ARGUMENTS 

-auto_write 

does not require the "w" request to be given in the editor in order to save editing 
changes. This is only meaningful if the transaction is entered from the terminal and 
ended with \f. 



*? A*" 
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-brief, -bf 

suppresses printing of the message indicating that the transaction was successfully entered. 

-fill, -fi 

fills the transaction after the user exits input mode. This is the default unless either the 
• -linejength control argument is used or the -linejength and -input_line_length (-ill) 
control arguments to the forum command are used. 

-force, -fc 

overwrites a previous unprocessed transaction without querying. 

-input_file pathname, -if pathname 

enters the segment identified by pathname into the proceedings. The default takes the 
transaction as it is typed in from the terminal and enters the request loop upon 
termination of input 

-linejength LENGTH, -11 LENGTH 

fills the transaction to the specified line length. The default is 72 columns unless a 
different value was given with the -output_line_length or -linejength control arguments 
to the forum command. 

-long, -lg 

prints a message indicating that the transaction was successfully entered. (Default) 

-meeting meeting_name, -mtg meeting_name 

enters the transaction into the proceedings of the meeting_name meeting. The default 
enters the transaction into the proceedings of the meeting the user is currently attending. 
The meeting_name argument can be a meeting name or a pathname. 

-no_auto_write 

requires the "w" request to be given in the editor in order to save editing changes. This 
is only meaningful if the transaction is entered from the terminal and ended with \f. 
(Default) 

-nojill, -nfi 
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transaction, unless either the -linejength control argument is used or the -linejength 
and -inputjinejength (-ill) control arguments to the forum command are used. 

-nojorce, -nfc 

query before overwriting a previous unprocessed transaction. 

-no_requestJoop, -nrql 

enters the transaction into the meeting without first entering the forum request loop. 
(Default except when -inputjile is used.) 

-requestjoop, -rql 

enters the forum request loop before the transaction is entered in the meeting. (Default 
except when -inputjile is used.) 
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-subject subject_string, -sj subject_string 

uses subject_string as the subject, avoiding the prompt for subject The default uses the 
subject of the transaction being replied to. If subject_string contains spaces, it must be 
quoted. 

-terminal_input, -ti 

inputs the transaction from the user's terminal. (Default) 

TERMINAL INPUT 

Unless the user makes use of the -inputjile control argument, the transaction is built by 
taking lines from the user's terminal. There are three methods of exiting from terminal input 
mode: 

Enters the transaction as is, returning to Forum request level. 

\f Exits terminal input mode and invokes the qedx editor on the transaction. 

| \f or \qf Exits terminal input mode and enters the Forum request loop. 

NOTES 

A transaction that was not entered via the period (.) to exit from terminal input mode can 
be entered from Forum request level via the "enter" request See the description of the 
"enter" request for details. 



Name: reset, rs 

SYNTAX 

rs {trans_specs} {-control_arg} 

FUNCTION 

The "highest transaction seen" is only maintained for pre-MRll version meetings. For current 
version meetings, seen switches should be used. See the description of the switch_on and 
switch_off requests. 

ARGUMENTS 

trans_specs 

is a transaction specifier that determines the value of the transaction number that the 
index is reset to. This can refer to only one transaction. If not specified, the default is 
the current transaction number. See Section 3 for complete information on transaction 
specifiers. 
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CONTROL ARGUMENTS 

-current 

adjusts the "current" index. (Default) 

-highest 

adjusts the "highest transaction seen" index. This control argument only applies to 
pre-MRll version meetings. 

-new 

makes the specified transaction the first "new" transaction. This is equivalent to "reset 
-highest trans_num-l". This control argument applies to pre-MRll version meetings. 

-next 

makes the specified transaction the "next" transaction. This is the same as "reset 
trans_num-l". 

NOTES 

The "current transaction index" is a logical pointer to a transaction in a meeting. Many 
Forum requests, including "print" and "write", use the value of this index if no transaction 
specifiers are supplied. It is initially set to the value of the "highest transaction seen" when 
the user enters a meeting. The "highest transaction seen" index is a logical pointer to the 
highest transaction that the user has printed or written to a segment This index is used when 
determining which transactions are "new". 



Name: retrieve, rt 

SYNTAX 

rt trans_specs 



allows participants to retrieve specified transactions that were previously deleted with the 
'delete' request The chairman can retrieve any deleted transaction. Other participants can 
only retrieve transactions that they authored and subsequently deleted. 

ARGUMENTS 

trans_specs 

are transaction specifiers that determine which transactions are retrieved (see below). See 
Section 3 for complete information on transaction specifiers. Regular expressions and 
Person_ids cannot be used as transaction specifiers with this request 
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LIST OF TRANSACTION SPECIFICATION CONTROL ARGUMENTS 

-after DT, -af DT 

selects transactions entered on or after the the date specified. The time of day is 
ignored. 

-after_time DT, -aft DT 

selects transactions entered after the date_time specified. 

-before DT, -be DT 

selects transactions entered before the date specified. The time of day is ignored. 

-before_time DT, -bet DT 

selects transactions entered before the date_time specified. 

-between DTI DT2, -bt DTI DT2 

selects transactions entered between the dates specified, inclusive. The times of day are 
ignored. 

-between_time DTI DT2, -btt DTI DT2 

selects transactions entered between the date_times specified, inclusive. 

-date DT, -dt DT 

selects transactions entered on the day specified. 

-from Person_id, -fm Person_id 

selects transactions entered by the participant named Person_id. 

-subject /REGEXP/, -sj /REGEXP/ 

selects transactions whose subject matches the given regular expression. 

-text /REGEXP/, -tx /REGEXP/ 

selects transactions whose text matches the given regular expression. 



Name: retrieve_participant, rtpt 

SYNTAX 

rtpt Person_ids {-control_args} 

FUNCTION 

logically retrieves the record of participation (attendee record) of a participant in a meeting 
after it has been deleted with the "delete_participant" request Only the chairman of the 
meeting can issue this request. 
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ARGUMENTS 



Person_ids 

are the names of the participants whose records are to be retrieved. 

CONTROL ARGUMENTS 

-brief, -bf 

suppresses the message "Specified switch was not changed." 

-long, -lg 

prints the message "Specified switch was not changed." if the record for that participant 
has not been deleted. (Default) 



Name: set message 

SYNTAX 

setjnessage {-control_args} 

FUNCTION 

allows the chairman to set a message that is to be printed the first time a user enters a 
transaction after entering a meeting The message is also printed the first time a user goes to 
the meeting after the message has changed. The message has a maximum size of 256 
characters. 

CONTROL ARGUMENTS 

-fill, -fi 

fills the message after the user exits input mode. This is the default unless the 
-no_input_fill (-nif) control argument was given with the invocation of forum. The 
default fill width is 72, but the user can specify the fill width via the -line_length NN 
(-11 NN) control argument to the forum command. 

-input_file pathname, -if pathname 

enters the segment identified by pathname into the proceedings. The default takes the 
message as it is typed in from the terminal and enters the request loop upon termination 
of input 

-no_fill, -nfi 

does not fill the message to the default fill width when entered. The default fills the 
transaction unless the -no_input_fill (-nif) control argument was specified when forum 
was invoiced. The fill width defaults to 72, unless the -linejength NN (-11 NN) control 
argument was specified when forum was invoked. (Default) 
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-no_request_loop, nrql 

enters the message into the meeting without first entering the forum request loop 
(Default except when -input_file is used.) 

-request_loop, -rql 

enters the forum request loop before entering the message in the meeting. 

-terminal_input, -ti 

inputs the message from the user's terminal. (Default) 

TERMINAL INPUT 

Unless the user makes use of the -input_file control argument, the message is built by taking 
lines from the user's terminal. There are three methods of exiting from terminal input mode: 

Enters the message as is, and returning to Forum request level. 

\f Exits terminal input mode and invokes the qedx editor on the message. 

\q Exits terminal input mode and enters the Forum request loop. 

NOTES 

To change a message, simply set the new message with "set_message". 

A message that was not entered via the period (.) exit from terminal input mode can be 
entered from Forum request level via the "enter" request See the description of the "enter" 
request for details. 



Name: subject, sj 

SYNTAX 

sj {new_subject} {-control_args} 

SYNTAX AS AN ACTIVE REQUEST 

[sj {new_subject} {-control_args}] 

FUNCTION 

changes the subject of the unprocessed transaction or prints/returns the subject of the 
unprocessed transaction. 
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ARGUMENTS 

new_subject 

is a string formed by concatenating the non-control arguments with intervening spaces. It 
becomes the subject of the unprocessed transaction. 

CONTROL ARGUMENTS 

-default 

changes the subject to that of the transaction that the unprocessed transaction is in reply 
to. This control argument can only be used with replies and cannot be used if 
new_subject is given. 

-subject, -sj 

begins the subject with the next argument Useful if the first character of the subject is 

NOTES 

When given no arguments, the subject request prints or returns the current subject of the 
unprocessed transaction, if any. An unprocessed transaction is a transaction that has been 
"built" by the user, either by exiting the "talk" request with the "\q" request or by using the 
"qedx" or "ted" requests; but has not yet been entered into a meeting. 



Name: subsvstem_name 

SYNTAX 

3ubsystem_name 

SYNTAX AS AN ACTIVE REQUEST 

[subsystem_name] 

FUNCTION 

prints the name of the subsystem; as an active request, returns the name of the subsystem. 
This is useful in abbrevs that are used in more than one subsystem. 



7-53 CY74-02 



subsystem_version switch_off 



Name: subsystem_version 

SYNTAX 

subsystem_version 

SYNTAX AS AN ACTIVE REQUEST 

[subsystem_ver s i on] 

FUNCTION 

prints the version number of the subsystem; as an active request, returns the version number 
of the subsystem. 



Name: switch off, swf 

SYNTAX 

swf switch_name {-control_args} 

FUNCTION 

turns off various Forum switches. 

ARGUMENTS 

switch_name 

is the name of the switch to reset. See "List of Switches" below. 

CONTROL ARGUMENTS 

-brief, bf 

suppresses the "Specified switch was not changed" error message which is printed when 
the user tries to set a switch that is already off. 

-meeting meeting_name, -mtg meeting_name 

sets the switch for the meeting identified by meeting^name. 

-user Person_id 

sets the switch for the user identified by Person_id. Only the chairman can set another 
user's flag. 

LIST OF SWITCHES 

adjourned, adj 
i reconvenes the meeting and allows users to attend the meeting again. 
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meeting_eligibility_messages, mtg_emsg 

turns off the printing of eligibility messages for the meeting. This switch can only be 
reset by the chairman, and can only be reset if the site administrators allow it (The 
default is site-dependent — see Appendix A.) 

notify, nt 

turns off the notify switch for the meeting. (This is the default) 

participating, part 

turns off the participation switch for the meeting. (The default is on.) 

safety 

turns off the storage system safety switch for this meeting. The switch will cause the 
delete command to query the user before the meeting is deleted. 

seen TRANS_SPECS 

marks the specified transactions as not having been seen. 



Name: switch on, swn 

SYNTAX 

swn switch_name {control_args} 

FUNCTION 

turns on various Forum switches. 

ARGUMENTS 

switch_name 

is the name of the switch to set See "List of Switches" below. 

CONTROL ARGUMENTS 

-brief, -bf 

suppresses the "Specified switch was not changed" error message which is printed when 
the user tries to set a switch that is already on. 

-meeting meeting_name -mtg meeting_name 

sets the switch for the meeting identified by meeting_name. This control argument cannot 
be used with the "seen" switch. 

-user Person_id 

sets the switch for the user identified by Person_id. Only the chairman can set another 
user's flag. 
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LIST OF SWITCHES 

adjourned, adj 

prevents users from entering the meeting. Only the chairman can set this switch. 

meeting_eligibility_messages, mtg_emsg 

turns on the printing of eligibility messages for the meeting. This switch can only be set 
by the chairman. (The default is site dependent — see Appendix A.) 

notify, nt 

turns on the notify switch for the meeting. This means that an interactive message will 

be sent each time a transaction is entered if the user is logged in and has issued the 

forum_accept_nOtifications command (described in Section 8). (The default is off.) 

participating, part 

turns on the participation switch for the meeting. (This is the default) 

safety 

turns on the storage system safety switch for this meeting. The switch will cause the 
delete command to qUery the user before the meeting is deleted. 

seen TRANS_SPECS 

marks the specified transactions as not having been seen. This means that the transaction 
has been printed, written or explicitly marked as seen by the switch_on request Type 
"help trans_specs" for information on transaction specifiers and for an explanation of the 
seen switch. 



Name: talk, t 

SYNTAX 

t {-control_args} 

FUNCTION 

allows a participant to build, and optionally enter into the proceedings of a meeting, a new 
transaction, 

CONTROL ARGUMENTS 

-auto_write 

does not require the "w" request to be given in the editor in order to save editing 
changes. This is only meaningful if the transaction is entered from the terminal and 
ended with \f. 

-brief, -bf 

suppresses the message that says that the transaction was successfully entered. 
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-fill, -fi 

fills the transaction after the user exits input mode. This is the default unless either the 
-linejength control argument is used or the -line_length and -input_line_length (-ill) 
control arguments to the forum command are used. 

-force, -fc 

overwrites a previous unprocessed transaction without querying. 

-input_file pathname, -if pathname 

enters the segment identified by pathname into the proceedings. The default takes the 
transaction as it is typed in from the terminal and enters the request loop upon 
termination of input 

-linejength LENGTH, -11 LENGTH 

fills the transaction to the specified line length. The default is 72 columns unless a 
different value was given with the -output_line_length or -linejength control arguments 
to the forum command. 

-long, -lg 

prints a message indicating that the transaction was successfully entered. (Default). 

-meeting meeting_name, -mtg meeting_name 

enters the transaction into the proceedings of the meeting_name meeting. The default 
enters the transaction into the proceedings of the meeting the user is currently attending. 
The meeting_name argument can be a meeting name or a pathname. 

-no_auto_write 

require the "w" request to be given in the editor in order to save editing changes. This 
is only meaningful if the transaction is entered from the terminal and ended with \f. 

-nojill, -nfi 

does not fill the transaction to the default fill width when entered. The default fills the 
transaction unless the -linejength control argument is used or the -linejength and 
-inputjinejength (-ill) control arguments to the forum command are used. 

-nojorce, -nfc 

query before overwriting a previous unprocessed transaction. 

-no_requestJoop, -nrql 

enters the transaction into the meeting without first entering the forum request loop. 
(Default except when -inputjile is used.) 

-requestjoop, -rql 

enters the forum request loop before entering the transaction in the meeting. 

-subject subject_string, -sj subject_string 

uses subject_string as the subject, avoiding the prompt for subject. The default prompts 
the user for the subject If subject_string contains spaces, it must be quoted. 

-terminaljnput -ti 

inputs the transaction from the user's terminal. (Default) 
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TERMINAL INPUT 

Unless the user makes use of the -input_file control argument, the transaction is built by 
taking lines from the user's terminal. There are three methods of exiting from terminal input 
mode: 

Enters the transaction as is, returning to Forum request level. 

\f Exits terminal input mode and invokes the qedx editor on the transaction. 

\q Exits terminal input mode and enters the Forum request loop. 

NOTES 

A transaction that was not entered via the period (.) to exit from terminal input mode can 
be entered from Forum request level via the "enter" request See the description of the 
"enter" request for details. 



Name: ted 

SYNTAX 

ted {-control_arg} 

FUNCTION 

invokes the "ted" editor to edit the text of the unprocessed transaction or to build a new 
transaction. 

CONTROL ARGUMENTS 

-auto_write 

specifies that the "w" request is not required to save editing changes. See "Notes". 

-fill, -fi 

specifies that the transaction is to be refilled upon exit from the editor. This is the 
default unless the -no_input_fill control argument was given to the forum command or 
unless the -no_fill control argument was given to the talk or reply request 

-no_filI, -nfi 

specifies that the transaction is not to be refilled upon exit from the editor. This is the 
default unless the -no_input_fill control argument was given to the forum command or 
unless the -no_fill control argument was given to the talk or reply request 

-no_auto_write 

specifies that the "w" request is required in order to save editing chnages. See "Notes". 
(Default) 
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NOTES 

If auto_write is not specified, the write (w) request must be used to save any changes made 
to the transaction back to forum. The write request can be used as often as desired to 
checkpoint the editing process. 

If the quit (q) request is issued and the transaction has been modified since it was last 
written, ted will query for permission to exit If permission is given, any changes made since 
the last write request will be lost The quit-force (qf) request can be used to abort unwanted 
editing of the transaction without being queried. 

If issued before use of the write request, the request line: 
! l,$dr 

will restore the original transaction text to the buffer. If given after a write request, this 
request line will restore the transaction as saved by the last write request given in the buffer. 



Name unmake_public, ump 

SYNTAX 

ump 

FUNCTION 

makes all users not explicitly eligible to participate in the current meeting ineligible. Users 
are made eligible to participate by using the add_participant and add_project requests. You 
can use this request if you have either modify permission on the containing directory or 
chairman access to the meeting. 

NOTES 

For information on converting a meeting, refer to "Duties of the Chairman" later in this 
manual. 
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write write 

Name: write, w 

SYNTAX 

w {trans_specs} {-control_args} 

FUNCTION 

writes the selected transactions into a segment 

ARGUMENTS 

trans_specs 

are transaction specifiers that determine the transactions to be written. See "List of 
transaction specification control arguments" below. See Section 3 for complete information 
on transaction specifiers. If no transaction specifiers are supplied, the current transaction 
is written. 

CONTROL ARGUMENTS 

-brief, -bf 

suppresses the message about how many transactions were written. 

-by_chain 

specifies that transactions are to be grouped by transaction chain. 

-extend 

writes the selected transactions to the end of the segment named either by the -pathname 
control argument or by default (see "Notes" below). (Default) 

-fill, -fi 

fills transactions before writing them to the file. The default is to fill transactions 
marked as unfilled when entered. The default line length is 72 unless another value is 
specified with the -line_length control argument or with the -line_length or 
-output_line_length control argument to the forum command. 

-format, -fmt 

specifies that transactions are to be written in a formatted fashion which includes page 
breaks. See "Notes on formatting" below. 

-include_deleted, -idl 

selects transactions even if they have been deleted. See "Notes" below. Default is 
-only_non_deleted. 

-initial 

writes only transactions that aTe at the beginning of transaction chains. 

-linejength LENGTH, -11 LENGTH 

fills transactions to LENGTH characters. (Default = 72) 
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-long, -lg 

prints the message about how many transactions were written. (Default) 

-meeting meeting_name, -mtg meeting_name 

selects the specified transactions from the meeting_name meeting. The default selects 
transactions from the current meeting. 

-no_fill, -nfi 

does not fill transactions when written. The default fills only transactions that were 
marked as unfilled when entered. 

-no_format, -nfmt 

specifies that transactions are to be written with no page breaks, headers, or footers. 
(Default) 

-no_separator, -nsep 

writes out transactions with a single blank line between them. 

-only_deleted, -odl 

selects only deleted transactions. See "Notes" below. Default is -only_non_deleted. 

-only_non_deleted, -ondl 

selects only non-deleted transactions. (Default) 

-pagejength LENGTH, -pi LENGTH 

specifies the number of lines to be printed on each page. LENGTH includes the page 
header and footer. This control argument is only applicable if -format is given. (Default 
= 60) 

-pathname PATH, -pn PATH 

writes the transactions selected to the segment identified by PATH. The ".trans" suffix is 
assumed. 

-reverse, -rv 

writes transactions in the reverse order of that given in the transaction specifier. 

-separator STR, -sep STR 

appends a separator string to each transaction written to the output segment. STR is an 
ioa_ control string of up to 256 characters. Default is a new page (" A !"). 

-truncate, -tc 

truncates the segment before writing the transactions to it 

LIST OF TRANSACTION SPECIFICATION CONTROL ARGUMENTS 

-after DT, -af DT 

selects transactions entered on or after the the date specified. The time of day is 
ignored. 

-after_time DT, -aft DT 

selects transactions entered after the date_time specified. 
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-before DT, -be ut 

selects transactions entered before the date specified. The time of day is ignored. 

-before_time DT, -bet DT 

selects transactions entered before the datejime specified. 

-between DTI DT2, -bt DTl DT2 

selects transactions entered between the dates specified, inclusive. The times of day are 
ignored. 

-between_time DTl DT2, -btt DTI DT2 

selects transactions entered between the datejimes specified, inclusive. 

-date DT, -dt DT 

selects transactions entered on the day specified. 

-from Person_id, -fm Person_id 

selects transactions entered by the participant named Person_id. 

-subject /REGEXP/, -sj /REGEXP/ 

selects transactions whose subject matches the given regular expression. 

-text /REGEXP/, -tx /REGEXP/ 

selects transactions whose text matches the given regular expression. 

NOTES 

If no pathname is given, the selected transactions are written to a segment in the working 
directory with the entryname meeting_name. trans. The user's current transaction index is set 
to the last transaction Written. 

In order to write a deleted transaction, the user must be either the chairman of the meeting 
or the author of the deleted transaction. 

NOTES ON FORMATTING 

Formatted output consists of a page header containing the current date and time, the name of 
the meeting, and the page number, plus a footer containing the subject of the first 
transaction on the page. The header and footer are separated from the text by a line of 
underscores and a blank line. Transactions are only split across pages if they are longer than 
one page. If a transaction does not fit on the remainder of the current page, a new page is 
always created. The -separator control argument cannot be used when formatting output. 
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This section contains descriptions of the Forum users' commands, presented in 
alphabetical order. These commands are for all Forum users, that is, for anyone who wants 
to find out about and attend meetings. Each description contains the name of the command 
(including the abbreviated form, if any), discusses the purpose of the command, and shows 
the correct usage. Notes and examples are included when deemed necessary for clarity. 

The syntax line demonstrates the proper format to use when invoking the command. 
The following conventions apply in the usage line: 

1. Optional arguments are enclosed in braces (e.g., {path}, {User_ids}). All other 
arguments are required. 

2. Control arguments are identified in the usage line with a leading hyphen (e.g., 
{-control_args} ) simply as a reminder that all control arguments must be 
preceded by a hyphen in the actual invocation of the command. 

3. To indicate that a command accepts more than one of a specific argument, an 
"s" is added to the argument name (e.g., paths, {paths}, {-control_args} ). 



8-1 CY74-02 



forum forum 

Name: forum 

SYNTAX AS A COMMAND 

forum {meeting_name} {-control_args} 

FUNCTION 

The forum command enters the Forum interactive meeting system. Once the command is 
invoiced, you are placed in the Forum subsystem, where you must use Forum requests. Forum 
requests are listed below under "List of Requests". (Forum requests are treated tutorially in 
Sections 2 through 5, and are fully described in Section 7.) 

ARGUMENTS 

meeting_name 

is the name or pathname of the meeting to be entered immediately upon invoking 
Forum. If a pathname is specified, it identifies the meeting to enter. Otherwise, Forum 
searches for meeting_name by using the forum search list See "Notes on Search List" 
below. 

CONTROL ARGUMENTS 

-abbrev, -ab 

specifies that abbreviation processing should be done by the Forum request processor. If 
the -profile argument is not given, the user's default profile segment 
(>udd>Project_id>Person_id>Person_id.profile) is used. 

-brief, -bf 

suppresses some messages from Forum and shortens others. 

-input_fill, -ifi 

fills transactions before entering them into the proceedings of a meeting. See "Notes on 
Filling" below for a discussion of filling. (Default) 

-input_line_length N, -ill N 

causes input filling (fill request and default filling) to be done with line length N. 
(Default is 72) 

-linejength N, -11 N 

causes both input and output filling (fill request and default filling) to be done with line 
length N. (Default is 72) 

-list {trans_spec} , -Is {trans_spec} 

lists the specified transactions before entering the request loop. If no transaction specifier 
is given, all the transactions in the meeting are listed. 

-long, -lg 

uses long messages from Forum. (Default) 
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-meeting meeting_name, mtg meeting_name 

enters the meeting whose entryname or pathname is meeting_name. See the description of 
the meeting_name argument above. 

-no_abbrev, -nab 

specifies that abbreviation processing is not to be done by the Forum request processor. 
(Default) 

-no_input_fill, -nif 

does not fill transactions before entering them into the proceedings of a meeting. See 
"Notes on Filling" below for a discussion of filling. 

-no_output_fill, -nof 

does not fill transactions before printing them on the user's terminal. See "Notes on 
Filling" below for a discussion of filling. (Default) 

-no_prompt 

does not prompt in the request loop. 

-no_start_up, -nsu 

does not execute the start_up exec_com. See "Notes on start_up" below. 

-output_fill, -ofi 

fills transactions before printing or writing. See "Notes on Filling" below for a discussion 
of filling. 

-output_line_length N, -oil N 

causes output filling (fill request and default filling) to be done with line length N. 
(Default is 72) 

-profile profile_path, -pf profile_path 

specifies that abbreviation processing is to be done using the profile named profile_path. 
If this control argument is given, the -abbrev argument need not be given. 

— nr/\mnt -rw/\tv»r»t e t *•■»«<* 

sets the request loop prompt to prompt_string. (Default is "forum:") 

-quit 

tells Forum to process the initial request line and then return without entering the 
request loop (even if the initial request line is aborted). 

-request string, -rq string 

executes the requests in string before entering the request loop. 

-start_up, -su 

executes the start_up exec_com. See "Notes on start_up" below. (Default) 

NOTES ON REQUESTS 

Request lines use for iteration, "" for quoting, and [] to invoke Forum active 
requests (listed below under "List of Active Requests"). 
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Any request line that begins with ".." is passed directly to the Multics command 
processor with the leading ".." stripped off. Consequently, any reference to an active function 
is evaluated by the Multics command processor. The "execute" (e) forum request can also 
make use of active strings via the square brackets ([]), but these are evaluated as active 
requests by Forum before the command line is passed to the Multics command processor. 

NOTES ON START UP 

If the -no_start_up control argument is not given, forum will search for and execute an 
exec_com file of forum requests. It will look for a segment named "start_up.fmec" in the 
home directory, project directory, and >site in that order. The start_up will be executed 
before going to the initial meeting and before executing the initial request line. 

NOTES ON FILLING 

Transactions can be filled out to a given line length on both input and output By 
default, all transactions input from the terminal are filled to a line length of 72 upon entry 
The -input_fill (-if) and -no_output_fill (-nof) control arguments are the default These 
control arguments specify a global attribute for the invocation of Forum, which can be 
overridden by control arguments associated with the various requests for inputting and 
outputting transactions (such as the -no_fill control argument to the "print" request). The 
-input_fill and -no_input_fill control arguments do not affect transactions entered using the 
-input_file control argument to the talk and reply requests. The fill width can be altered by 
control arguments to the forum command (-linejength, -input_line_length and 
-output_line_length) and by the -linejength control argument to the forum requests that fill 
transactions. 

LIST OF REQUESTS 

Listed below are the available requests that you can use once you are in the Forum 
subsystem. These requests are described in detail in Section 7. Certain common requests are 
described tutorially in Sections 2 through 6 of this manual. 

? 

lists the available forum requests and active requests. 

identifies Forum with version number; gives meeting_name if attending gives count of 
new, total, last, and current transactions; and gives number of lines in the unprocessed 
transaction. 

abbrev {-control_args} , ab {-controLargs} 

turns abbreviation processing on or off and changes profile segments. 

add_meeting 

adds a meeting to the list of meetings attended. Makes the user a participant of the 
meeting. 

add_participant NAME {-control_arg} , apt NAME {-control_args} 

allows a user to participate in the meeting. (A chairman request only). 
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add_project NAME {-control_arg} , apj NAME {-controLargs} 

allows a project to participate in the meeting. (A chairman request only). 

announce_meeting 

places an announcement of the current meeting in another meeting. This announcement 
s^relTlis^ adcLmeeting request by other users to add this meeting to their 

announcement_info 

extracts information from a meeting announcement produced by the announce_meeting 

answer STR {-control_args} requestjine 

supplies an answer to a question asked by a request STR is the desired answer to the 
question and requestjine is the Forum request line. 

apply commandjine, ap command_line 

SS 68 *? 6 ""f 00688 ^ ^ ansaction into a temporary segment, concatenates command line 
with the pathname, and passes the result to the Multics command processor "The 
temporary segment is then read back in as the unprocessed transaction. 

chairman {meeting_name} , cm {meeting_name} 

prints the User_id (Person Jd.ProjectJd) of the meeting's chairman. 

checkjneetings 

establishes a list of meetings to be flagged when changed. The meeting can be 
successively viewed with the next_meeting (nm) request. 

current_meeting {-control_args} , cmtg {-controLargs} 
prints the name of the current meeting. 

delete trans_specs, dl trans_specs 

allows the chairman to delete specified transactions from the proceedings. 

do {requestjine} {args}, do {-controLargs} 

substitutes args into the requestjine and passes the result to the Forum request processor 

HnT brfoTeTSor ~ n ° 8 ° t0 SUPPr£SS eXeCUti ° n ° r " l0ng Hg) to display expanded ' 

enter {-controLargs}, en {-controLargs}, send {-controLargs} 

enters the unprocessed transaction into the proceedings of a meeting. 

exec_com PATH STRs, ec PATH STRs 

executes an exec_.com segment containing forum requests where PATH is the pathname of 
the exec_com segment (the ".fmec" suffix is assumed) and STRs are arguments to be 
passed to the program. 

execute STRs, e STRs 

executes STRs as a Multics command line after evaluating Forum active requests. As an 
active request, returns the result of evaluating strings as an Multics active string. 
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fill {-control_args} , fi {-controLargs} 

reformats transaction text to fit in a given line length. 

forum_dir, fd 

prints the pathname of the central forum directory. 

goto meeting_name, g meeting_name 

enters the user into the meeting_name meeting. 

help {STR} 

prints information about request names or topics. A list of available topics is produced 
by the listjielp request 

if EXPR -then LINE1 {-else LINE2} 

conditionally executes one of two request lines depending on the value of an active 
string. EXPR is the active string that must evaluate to either "true" or "false". LINE1 is 
the Forum request line to execute if EXPR evaluates to "true". LINE2 is the Forum 
request line to execute if EXPR evaluates to "fake". 

list {trans_specs} {-controLargs}, Is {trans_specs} {-control_args} 
prints a summary of the specified transactions. 

listjielp {topics}, lh {topics} 

prints a list of available info segments whose names include a topic string. 

list_meetings {meeting_names} {-control_args} , Ism {meeting_names} {-control_args} 
prints a list of selected meetings and information about them. 

list_requests {-control_args} , lr {-control_args} 
prints information about forum requests. 

list_users {-control_args} , lsu {-controLargs} 

prints information about specified participants in a meeting. 

mail 

sends a transaction or set of transactions to other users, mailing lists, or forum meetings 
using the Multics mail system. 

make_public, mp 

allows all users on the system access to the meeting. (A chairman request only.) 

next_meeting 

changes the current meeting to the next meeting in the list of changed meetings 
established by the checkjneetings request 
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print {trans_specs} {-control_args} , pr {trans_specs} {-control_args} 
prints selected transactions from a meeting. 

qedx, qx 

invokes the qedx editor on the unprocessed transaction. 

quit {-control_arg}, q {-control_arg} 
exits Forum. 

remove_meeting 

removes meetings to the user's forum search list by deleting links to them from the 
directory >udd>Project>Person>meetings. 

remove_participant NAME, rpt NAME 

denies the user permission to participate in the meeting. (A chairman request only.) 

remove_project NAME, rpj NAME 

denies users on a project permission to participate in the meeting. (A chairman request 
only.) 

reply {trans_spec} {-control_args} , rp {trans_spec} {-control_args} 

enters/builds a new transaction in a meeting that has as its subject a reference to some 
other transaction in the form "Re: <some other subject>", and which will be logically 
linked to the transaction specified by trans_spec. 

reset {trans_spec} {-control_args} , rs {trans_spec} {-control_args} 

resets the user's current or highest-seen transaction index to the specified transaction. 

retrieve trans_specs, rt trans^specs 

retrieves specified transactions that were previously deleted with the "delete" request 
Only the chairman or the author of the deleted transaction can use this request 

set_message {-controi_args} 

sets a greeting message for the meeting. The default action puts the user into input 

mode tO STieeifv thft mp«agp f A rh airman r/tniiAct /\m1\7 \ 



subject {strings}, sj {strings} 

prints or modifies the subject of an unprocessed transaction. If strings are supplied, they 
are catenated together to become the new subject If no strings are supplied, the current 
subject is printed. 

subsystem_name 

prints the name of the subsystem ("forum"). 

subsystem_version 

prints the current version of Forum. 
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switch_off switch {-control_args} , swf switch {-control_args} 
turns off various Forum switches. Switches are: 

adjourned, adj 

meet i ng_e 1 i g i b i 1 i tyjnessages , mtg_emsg 

notify, nt 

participating, part 

switch_on switch {-control_args} , swn switch {-control_args} 
turns on various Forum switches. Switches are: 

adjourned, adj 

meeting_el igibi i i tyjnessages, mtg_emsg 

notify, nt 

participating, part 

talk {-control_args} 

enters/builds a new transaction in a meeting. 

ted 

invokes the ted editor on the unprocessed transaction. 

unmake_public, ump 

allows only users granted explicit permission to participate in the meeting. (A chairman 
request only.) 

write {trans_specs} {-control_args} , w {trans_specs} {-control_args} 
writes selected transactions to a segment. 

LIST OF ACTIVE REQUESTS 

[chairman {meeting_name} ] , [cm {meetingjiame} ] 

returns the Person_id.Project_id of meeting chairman. 

[current_meeting {-control_args} ] , [cmtg {-control_args} ] 
returns the name of the current meeting. 

[do {request_string} {args}] 

returns expanded request string. 

[exec_com PATH STRs], [ec PATH STRs] 

executes an exec_com segment containing forum requests. 

[execute STRs], [e STRs] 

invokes Multics active function within forum request line. 

[f orum_dir] , [f d] 

returns absolute pathname of central forum directory. 
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[if EXPR -then STR1 {-else STR2}] 

returns one of two character strings to the Forum request processor depending on the 
value of EXPR. EXPR is the active string that must evaluate to either "true" or "false". 
STR1 is returned if EXPR evaluates to "true". STR2 is returned if EXPR evaluates to 
"false". 

[list_meetings {-control_args} ] , [Ism {-control_args} ] 
returns names of meetings that have new transactions. 

[list_users {-control_args} ] , [lsu {-control_args} ] 

return names of participants matching given conditions. 

[next_meeting] 

returns the name of the next meeting in the list of changed meetings established by the 
check_meetings request 

[subject], [sj] 

returns the subject of an unprocessed transaction. 

[subsystem„name] 

returns the name of the subsystem ("forum"). 

[subsystem_version] 

returns the current version of Forum. 

TRANSACTION SPECIFIERS 

Transaction specifiers identify transactions. They are used as arguments to the forum requests 
that act on transactions. In addition, there are several requests and active requests that return 
information about transaction numbers. See Section 3 for complete information about 
transaction specifiers. 

NOTES ON SEARCH LIST 

The fnrtim rnmmanH iicac xhp- "forum" cA**rr4i «ath P/vr m/vr^ infArmitJA« oiwn+ ™«-«v, ««*u~ 

see the descriptions of the search facility commands in the Commands manual. For details on 
the forum search path, see Section 2. 
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Name: forum_accept notifications, fant 

SYNTAX AS A COMMAND 

fant 

FUNCTION 

enables reception of interactive messages notifying the user of new transactions being entered 
in meetings for the duration of this login session. Notifications are enabled for all meetings 
for which the user has set the notify flag. See the description of the switch_on request in 
Section 7 to find out how to set the notify flag. 
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Name: forum__add meeting, fam 

SYNTAX 

fam {trans_specs} {meeting_names} {-control_args} 

FUNCTION 

adds meetings to the user's forum search list by placing links to them in the directory 
>udd>Project>Person>meetinp, and makes the user a participant in the meeting. 

ARGUMENTS 

trans_specs 

are transaction specifiers identifying transactions created by the announce_meeting request. 
If any trans_specs are given, they must precede all meeting_names. At least one 
trans_spec or meeting_name must be given. See Section 3 for more information on 
transaction specifiers. 

meeting_names 

are pathnames of forum meetings to be added to the search list. 

CONTROL ARGUMENTS 

-current_meeting, -cmtg 

adds the current meeting to the search list. 

-directory PATH, -dr PATH 

places the links in the specified directory instead of the default directory of 
>udd>Project>Person>meetings. 

-force, -fc 

adds the link even if the user is not eligible to participate in the meeting. 

-no_force, -nfc 

does not add the link if the user is not eligible to participate in the meeting. (Default) 

-update, -ud 

changes all links to pre-MRll meetings into links to a current version meeting if that 
meeting exists in the directory that the link points to. For more information on 
converting a meeting, refer to "Duties of the Chairman" later in this manual. 

NOTES 

If the directory >udd>Project>Person>meetings does not exist, and the -directory control 
argument is not given, a link with that name pointing to >udd>Project>Person is created in 
>udd >Pro ject>Person. 
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Name: forum delete, fdl 

SYNTAX AS A COMMAND 

fdl meeti ng_name 

FUNCTION 

deletes the specified meeting. 

ARGUMENTS 

meeting_name 

is the pathname or entryname of the meeting to be deleted. Pathnames contain 
greater-than (>) or less-than (<) characters. If a pathname is specified, it identifies the 
meeting to be deleted. Otherwise, fdl searches for the meeting_name by using the forum 
search path. 

ACCESS REQUIRED 

The user must have "m" access to the directory containing the meeting to delete the meeting. 

NOTES 

If you aTe using this command to delete a pre-MRll version meeting that has been converted 
to a current version meeting, you must use the suffix ".control" after the meeting name. The 
syntax is: 

fdl meet ingname. control 

For information on converting a meeting, refer to "Duties of the Chairman" later in this 
manual. 
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Name: forum_dir, fd 

SYNTAX AS A COMMAND 

fd 

SYNTAX AS AN ACTIVE FUNCTION 

[fd] 

FUNCTION 

prints/returns the absolute pathname of the central meeting directory. 

NOTES 

The central forum directory is the location for site-approved public meetings. This directory 
is included in the default forum search path. 
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Name: forum iist__meetings, fism 

SYNTAX AS A COMMAND 

flsm {meeting_names} {-control_args} 

SYNTAX AS AN ACTIVE FUNCTION 

[flsm {-contro1_args}] 

FUNCTION 

pints a list of selected meetings on the user's terminal. For each meeting selected, 
information about the names of the meeting and per-user meeting attributes are listed. 

ARGUMENTS 

meeting_names 

are optional meeting_names. If any are supplied, information about only the specified 
meeting_names is printed. The star convention is supported for meeting_names. If no 
meeting_names are given, information for all meetings found in the forum search path is 
printed. 

CONTROL ARGUMENTS 

-absolute_pathname, -absp 

prints the absolute pathname of a meeting. The default lists the long and short meeting 
names only. 

-adjourned, -adj 

selects information about meetings that have been adjourned. 

-all, -a 

prints information about all meetings. The default prints information about the meetings 
in which the user is eligible to participate only. 

-brief, -bf 

suppresses the message "No meetings have changed" which is printed by default if the 
-changes control argument is used and no meetings have changed. 
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-chairman {Person_id}, -cm {Personjd} 

prints information about meetings of which Person_id is chairman. If Person_id is not 
given, the user's Person_id is used. 

-changed, -chg 

prints information about meetings in which the user is a participant and new transactions 
have been entered. 

-count, -ct 

prints out the number of new transactions for a meeting in which the user is 
participating. This control argument cannot be used if forumjist is invoked as an active 
function. 

-eligible, -elig 

prints information about all meetings in which the user is eligible to participate 
(Default) 

-exclude meeting_names, -ex meeting_names 

excludes the meetings identified by meeting_names from the output list. This control 
argument is designed to be used when a starname has been supplied as meeting_names in 
order to exclude the specified meetings from being selected. The default (-include) is to 
select all meetinp that match the specified starname. 

-from DT, -fm DT 

selects meetings which have changed since the specified time. DT is any string acceptable 
to the convert_date_to_binary_ subroutine. The default is the current time. 

-header, -he 

prints the meeting header. This is the default, unless the -changes control argument was 
supplied. 

-include meeting_names, -incl meeting_names 

includes the meetings identified by meeting_names in the output list. This control 
argument is intended to be used when a starname has been specified for selecting 
meetings. (Default) 

-inhibit_error, -ihe 

does not print warning messages for such as things as bad meeting format and errors 
encountered while searching for meetings. (Default) 

-long, -Ig 

prints the message "No meetings have changed" if the -changes control argument is used 
and no meetings in which the user is a participant have changed. (Default) 



8-15 CY74-02 



forum_list_meetings forum_list_meetings 



-no_cnanges, -ncng 

does not list changed meetings. 

-no_adjourned, -nadj 

does not list adjourned meetings. 

-no_header, -nhe 

suppresses printing of the meeting header. 

-no_inhibit_error, -nine 

prints all warning messages. 

-no_notify, -nnt 

does not list meetings in which the user has the notify flag set 

-no_participating, -npart 

does not list meetings in which the user is a participant 

-no_read_only, -nro 

does not list meetings to which the user has only read access. 

-notify, -nt 

lists only meetings in which the user has the notify flag set 

-participating, -part 

lists only meetings in which the user is participating. The default prints information 
about all meetings that the user is eligible to participate in. 

-read_only, -ro 

lists just the meetings to which the user has only read access. 

-user User_id 

determines participation, eligibility, and changes attributes for the user specified by 

User_id. User_id is in the form Person_id.Project_id.tag, where any of the components 

can be the character "*". If a component is omitted, it is assumed to be "*". 

-verbose, -vb 

prints the chairman's User_id and current and last transactions for each meeting. This 
control argument cannot be used with the -changes control argument or when invoking 
flsm as an active function. 
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NOTES ON FLAGS 

The output from this command may include flags that have the following interpretation: 

a attending flag 

the user is currently attending the meeting 

c change flag 

new transactions have been entered in the proceedings of the meeting since the 
user last attended this meeting. 

e eligible flag 

the user can participate in the meeting. 

j adjourned flag 

the chairman has temporarily adjourned the meeting. 

n notify flag 

the user has turned on the notify flag in the meeting (i.e., the user has 
requested online notification when new transactions are entered in the meeting). 

o observer flag 

the user has only read access to the meeting. 

p participant flag 

the user is a participant in meeting (i.e., has gone to the meeting at least 
once). 

r removed flag 

the user has removed himself from participation in the meeting. 

The flags corresponding to the selection criteria are not shown (i.e., if the user is selecting 
meetings to which he is eligible, the "e" flag is not printed, it is assumed). 
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forum_list users *„ ,. ♦ 

forum_hst_users 



Name: forum list__users, flsu 

SYNTAX AS A COMMAND 

flsu {meeting_name} {-control_args} 

SYNTAX AS AN ACTIVE FUNCTION 

[flsu {meet i ng_name} {-control_args}] 

FUNCTION 

iK? & * *£ ° f . !f leCted P^ 110 ^ 1115 of a meeting. For each participant selected, the 
Person_id, frojecud, current transaction number (last one seen), the date/time last attended 
and several flags are listed. As an active function it returns a list of Person_ids. 

ARGUMENTS 

meeting_name 

is the name or pathname of the meeting for which participants are to be listed Either 
Urn argument or the -meeting control argument (but not both) must be given. 

CONTROL ARGUMENTS 

-after TIME, -af TIME 

lists only those participants who have attended since the given time. 

-all, -a 

lists all participants, including those who are not participating in the meeting. 

-ascending, -asc 

sort in ascending order. This is the default for sorting by name. This may not be used 
if invoked as an active request 

-attending, -at 

lists only participants who are currently attending this meeting. 

-before TIME, -ne TIME 

lists only those participants who have not attended since the given time. 

-brief, -bf 

suppresses the message "No participants were selected." 

-descending, -dsc 

sort in descending order. This is the default for sorting by time last attended This 
control argument cannot be used if list_users is invoked as an active request 
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-eligible, -elig 

prints a list of users and projects that are eligible to attend the meeting. Read-only 
eligibility is denoted by an asterisk (*). This control argument cannot be used if 
list_users is invoked as an active request This control argument cannot be combined with 
any other control argument 

-header, -he 

prints the header, prints the header. This control argument cannot be used if list_users 
is invoked as an active request (Default) 

-long, -lg 

prints the "No participants were selected." message if this is the case. (Default) 

-meeting meeting_name, -mtg meeting_name 

lists participants of the meeting_name meeting. The meeting_name argument can be either 
a name or a pathname of a meeting. The default lists participants of the current 
meeting. 

-names_only 

only prints the names of the selected participants. This control argument is not valid if 
names_only is invoked as an active request 

-no_header, -nhe 

suppresses printing of the hame_list header. 

-no_participating, -npart 

lists only those users who are no longer participating. 

-no_read_only, -nro 

does not list read— only participants. 

-notify, -nt 

lists only participants with the notify flag on. 

-only_deleted, -odl 

lists only information for participants who have been deleted by the chairman. (Default) 

-only_non_deleted, -ondl 

lists only information for participants who have not been deleted by the chairman. 
(Default) 

-participating, -part 

lists only users who are participating. (Default) 

-project Project_ids, -pj Project_ids 

lists only information about participants on the specified project All arguments following 
-project until the next control argument are taken as Project_ids. 



8-19 CY74-02 



forum_list_users forum list users 



-read_only, -ro 

lists just read-only participants. 

-seen transaction_number 

lists only participants who have read the specified transaction. 

-sort TYPE 

sorts the output by TYPE TYPE is either "name" for sorting by the Person_id of 
participants, or "date_time_attended" (dta) for sorting by the time the participant last 
attended the meeting. This control argument can not be used for the active function. 

-totals, -tt 

prints only the total number of participants selected. 

-unseen transaction_number 

lists only participants who have not read the specified transaction. 

-user Person_ids 

prints only information about the named participants. All arguments following -user until 
the next control argument are taken as Person_ids. 

NOTES 

The displayed flags have the following meanings: 

r the participant has been removed from the meeting and is therefore no longer 

a participant 

n the user has the notify flag turned on. 

o the user is an observer and cannot enter transactions. 
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Name: forum refuse_notifications, frnt 

SYNTAX AS A COMMAND 

frnt 

FUNCTION 

disables reception of interactive messages notifying the user of new transactions being entered 
in meetings. 
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Name: forum remove meeting, frm 

SYNTAX AS A COMMAND 

frm 

FUNCTION 

removes meetings in the user's "forum" search list by deleting links to them from the 
directory >udd>Project>Person>meetings. 

ARGUMENTS 

meeting_names 

are names of forum meetings to be removed from the search list The star 
convention is allowed. 

CONTROL ARGUMENTS 

-check, -ck 

lists all links to meeting in >udd>Project>Person>meetings that point to non-existent 
meetings. Incompatible with -cleanup. 

-cleanup 

removes all links to forum meetings from >udd>Project>Person>meetings that point 
to nonexistent meetings. Incompatible with -check. 

-directory PATH, -dr PATH 

removes the links from the specified directory instead of the default directory of 
>u'dd>Project>Person>meetings. 

NOTES 

If a meeting is found through some other entry in the "forum" search list, the site's 
central forum directory for instance, this command cannot remove it 
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SECTION 9 
DUTIES OF THE CHAIRMAN 



This section shows how to create and maintain meetings. For detailed descriptions of 
the chairman's commands referred to here, see Section 10. 

CREATING A MEETING 

To create a meeting, use the forum_create (fcr) command. Forum asks you for all the 
necessary information, step by step. In the following example, assume that the user named 
Fox on the ProjA project wants to create a meeting in her working directory and that she 
wants it to be a public meeting. 

! fcr 

Enter pathname of meeting directory (carriage return for 
working_dir) : ! <CR> 

Please enter long meeting name (<20 characters) : ! home_computers 

Now enter abbreviated meeting name: ! he 

Should the meeting be public? ! yes 

Do you want to enter a chairman message (? for explanation)? ! yes 

Message: 

! Welcome to the home_computers meeting. 

! . 

The home_computers meeting has been established in >udd>ProjA>Fox. 

You must now enter the first transaction in the home_computers meeting, 

which will act as as an introduction. 

The meeting is public. Welcome to the home_computers meeting. 

Transaction: 
! This meeting is designed to allow anyone interested in personal 
! computing to discuss any issues related to such. Participants are 
! asked to indicate which home computer they have. 
! . 

Transaction [0001] entered in >udd>ProjA>Fox>home computers meeting. 

Do you want to announce this meeting? lyes 

Enter the name of the meeting where the announcement should be made. 

Enter carriage return for >site>forum_dir>Meetings_Di rectory 
! <CR> 

Please enter a short description of the access to the meeting. 
! This meeting is open to the public. 

r 10:30 2.096 87 
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Now, if you reenter Forum and go to the home_computers meeting, Forum tells you 
that you are the chairman. The subject is automatically added to the first transaction since 
the first transaction is always the introduction. 

home_computers meeting: new, I last (You are the chairman). 

forum: ! p 1 

[0001] (J* lines) Fox.ProjA Olt/28/82 1030.2 est Wed eve 

Subject: Reason for this meeting 

<same text as shown in above example> 

— [0001] — 

If you decide that you want to invite private participation only, you can specify exactly 
who can attend. When Forum asks whether the meeting should be public, simply reply no. 
Forum then offers to let you name individuals and/or whole projects as eligible participants. 
Individuals are specified by their Person_ids, and projects are specified by their Project_ids. 
The example below illustrates the questions asked by Forum. This sample meeting is created 
by Fox and is named basic_problems (basprob). 



Should the meeting be public? ! no 

Should specified individuals be allowed to participate? ! yes 

Now please type Person_ids of attendees when prompted. 
Signal the end of the list by typing a period only. 

Person_id: ! Montgomery 
Person_id: ! Manselle 
Person_id: ! . 

Should specified projects be allowed to participate? ! yes 

Now please type Project_ids when prompted. 

Signal the end of the list by typing a period only. 

Projected: ! ProjA 
Project_id: ! ProjB 
Project_id: ! . 

Person_ids and Project_ids are entered in a list, each followed by a carriage return 
(RETURN). When your list is complete, type a "." on a line by itself. 

Now that you have selected the possible eligible participants, you are prompted for the 
chairman's message, and the meeting is established. After you enter the first transaction, you 
are asked if you want to announce this meeting and you enter the name of the meeting 
where the announcement should be made. You are then asked to enter a short description of 
the access to the meeting. 
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Do you want to enter a chairman message (? for explanation)? ! yes 

Message: 

! This is a developmental meeting 

! open to engineers only. 

The basic_prob1ems meeting has been established in >udd>ProjA>Fox. 

You must now enter the first transaction in the basic_problems 

meeting, which will act as an introduction 

This is a developmental meeting open to engineers only. 

Transaction: 
! transaction text> 
! . 

Transaction [0001] entered in >udd>ProjA>Fox>basic_problems meeting. 
Do you want to announce this meeting? ! yes 

Enter the name of the meeting where the announcement should be made. 
Enter carriage return for >site>forum dir>Meetings Directory 
<CR> ~ - r 

Please enter a short description of the access to the meeting. 
This meeting is open to the public, 
r 10:30 2.096 87 



MAINTAINING A MEETING 

As chairman, you can adjust the list of users who are eligible to participate in vn U r 
meeting, adding and deleting users and projects as necessary at any time. The -readjonly 
control argument to the forum_add_participant and forum = add_project commands (d^rihed 
below) lets you specify that certain users and/or groups of users be allowed only to read 
transactions, not to enter them. 

You also have the right to use certain Forum requests to delete offensive or irrelevant 
transactions, giving proper notice to the participants, and to retrieve transactions 

As chairman, whether you created the meeting or inherited the chairmanship, you alone 
nave the right to alter any aspects of the meeting. 

Adding a Participant 

It is simple to add a participant to the list of users who are eligible to attend your 
meeting. The forum_add_participant (fapt) command adds users to the list, one at a time To 
add the user White to the list of participants for the home^comouter meeting that has bee« 
added to your search rules, type: 



! fapt home_computer White 

White added to the home computer meeting, 

r 08:lt2 0.247 66 
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To change the access of a participant to read only, use the forum_add_participant (fapt) 
command with the -read_only (ro) control argument to add the participant again. This 
changes the original access of the participant to read only. (See the forum_add_participant 
command later in the manual.) 

Adding a Project 

Adding a project name to your list of eligible participants is done the same way as 
adding a user, only with the forum_add_project (fapj) command. (You can only add one 
project at a time.) The example below shows two projects being added to the list of eligible 
participants. 

! fapj home_computer ProjB 

ProjB added to the home computer meeting. 

r 08:53 0.290 66 

! fapj home_computer Engr 

Engr added to the home_computer meeting. 

r 08:51* 0.187 66 

To change the access of a project to read only, use the forum_add_project (fapj) 
command with the -read_only (ro) control argument to add the project again. This changes 
the original access to allow users on the project to read transactions but not enter them. (See 
the forum_add_project (fapj) command later in this manual.) 

Making a Meeting Public 

The forum_make_public (fmp) command opens a meeting to public participation, thereby 
overriding any explicit eligibility requirements that may have previously been set. You can, 
however, remove participants and projects from a public meeting with the 
forum_rernove_participant and forum_remove_projeci commands (described below). 



S fmp home_computer 

Meeting home_computer is now public. 

r 08:57 0.319 1 



Making a Meeting Private 



Suppose you want to make a previously public meeting private and deny participation 
rights to an individual or a project 
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The forum_unmake_public (fump) command makes a formerly public meeting into a 
private one. 

! fump home_computer 

Meeting home_computer is no longer public. 

r 08:06 0.215 63 

Now that the meeting is private, you must explicitly make users eligible to attend, or 
no one will be able to. Use the forum_add_participant and forum_add_project commands as 
shown above. 

Removing a Participant 

Three levels of removal (access denial, logical removal, and physical removal) allow you 
to bar participants in degrees of permanency. 

On the top level, you can deny access to a meeting for a participant with the 
forum_remove_participant (frpt) command. This command removes the user's record of 
participation or attendee record (showing User_id, last time attended, and last transaction 
seen) from the list of participants that the "list_users" request normally displays. Any user 
can, however, see the names of removed participants by using the "list_users -all" request, 
which includes in its display removed participants (indicated by the "r" flag). 

To remove a participant from the list of eligible participants, use the forum_remove participant 
(frpt) command: 

! frpt home_computer White 

White has been removed from the home computer meeting. 

r 08:10 0.347 86 

You can go one step further and logically remove (i.e., conceal from public view) that 
user's record of participation in your meeting with the "delete_participant" request 

forum: ! dipt White 



When you issue this request, Forum does not print an acknowledgment— the participant is 
simply removed. Now the user's record of participation is invisible to everyone but the 
chairman. You can still change your mind and retrieve the record with "retrieve_participant" 
which replaces that user's record in the list of users. 

To physically (and finally) remove a participant's record, use the "expunge" request 
which physically removes all deleted participants from a meeting. Note that participants to be 
expunged must first be deleted with the delete_participant request 
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forum: ! expunge -participants 

forum (expunge): Expunging the meeting will destroy all records 

of deleted participants. Do you really want to expunge the 

home_computer meeting? ! yes 

k participants expunged. 

forum: 

This request allows you to reclaim space and save your quota. This is necessary if 
your meeting is too big and in danger of running out of storage space (approaching 
the limit of 500 attendees.) The "expunge" request also validates the internal structure 
of the meeting and deletes damaged items, but it is time-consuming and generally only 
done to save a meeting. 

Removing a Project 

To remove a Projected from the eligible list, use the forum_remove_projeet 
(frpj) command: 

! frpj home_computer ProjB 

Project ProjB removed from home_computer meeting. 

r 08:14 O.i+21 86 



I Maintaining Meeting Access 

If a meeting was created with the MRU (or later) version of forum, you can 
use the standard access control list (ACL) commands (list_acl, set_acl, and delete_acl). 
You can use these commands to add participants or projects to the list of users who 
are eligible to attend your meeting. You can also use these commands to deny 
members rights to a meeting or to limit participants to read only status. Additionally, 
you can use these commands to remove a project from the eligible list. 

If you are not in the directory containing the meeting, you must include the full 

pathname of the meeting including the ".forum" suffix. If you are in the meeting 

directory containing the meeting, you only need to include the name of the meeting 
and the ".forum" suffix. 



To add a participant to the list of users who are eligible to attend your meeting, 
you can use the set_acl command. This command is equivalent to the forum_add_participant 
command and adds users to the list one at a time. If you are in the directory 
containing the accounting meeting and you want to allow the user McElvenny to 
attend the accounting meeting, type: 

! set_acl accounting. forum rw McElvenny 

r 0.8:42 0.246 66 
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To allow the public read transactions in a meeting but not enter them, you can use the 
set_acl command with r.* status. This command line is equivalent to the forum_make public 
command used with the -read_only control argument If you are in the directory containing 
the accounting meeting and want to allow the public to read transactions in the accounting 
meeting, but not enter them, type: 

! set_acl accounting .forum r.* 

To remove a Projected from the eligible list, you can use the set_acl command with 
null status. This command line is equivalent to the forum_remove_project (frpj) command. If 
you are in the directory containing the budget meeting and want to remove the Marketing 
project from the budget meeting, type: 

! set_acl budget. forum null *. Marketing I 



r 0:42 0246 66 



Deleting Transactions 



Occasionally you will need to delete transactions. As chairman, you have the power to 
remove offensive or irrelevant transactions. Two levels of deletion (logical removal and 
physical removal) allow you to remove transactions in degrees of permanency. First, the 
Forum "delete" (dl) request logically removes specified transactions from a meeting. You can 
delete a range of transactions, if necessary. In the example below, the chairman deletes the 

u cuu>a<*aiwii wiuic aiicuuuig me mtcmig. 

forum; ! dl 7 
forum: 

After Forum deletes the transaction, it puts you back into the request loop. Thereafter, when 
any attendee attempts to specify the deleted transaction, Forum answers that the transaction 
has been deleted. 

forum: ! Is 7 

forum (list): The specified transaction has been deleted. Transaction 7. 

forum (list): No transactions were selected. 

forum: 

The first Forum message in the above example explains that transaction 7 has been deleted 
and will therefore not be found by the "list" request. Since no transactions other than 
transaction 7 were specified in the request line, the "list" request has not selected any 
transactions and therefore printed the second message. If the request had specified two 
transactions (e.g„ "Is 7:8"), Forum would have listed only transaction 8. 

Remember that position 7 in the proceedings is permanently filled, even though the 
transaction has been deleted. The next transaction entered is numbered 8, and transaction 7, 
although it no longer appears in the proceedings, is saved elsewhere and can be retrieved at 
any time with the "retrieve" request (see below). 
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I 



forum: 
Trans# 
[0001] 
[0002] 
[0003] 
[0004] 
[0005] 
[0006] 
[0008] 

forum: 



! Is 1 
Lines 

(5) 

(3) 

(3) 



:8 

Date 
05/18/81 
05/20/81 
05/21/81 



Time Author 

03:20 Brooks. Proj A 

03:46 Davis. YAK 

06:1»9 Smith.ProjB 



Subject 

Reason for this meeting 
Fortran for a Begi<More> 
Other Meetings 



Notice that there is no transaction [0007] listed. As chairman, you usually enter another 
transaction yourself to explain the disappearance of other transactions, explaining why the 
deletion was necessary. 

Second, to physically (and finally) remove deleted transactions from the meeting, use the 
"expunge" request 

forum: ! expunge -transactions 

forum (expunge: Expunging the meeting will destroy all records 

of deleted transactions. Do you really want to expunge the 



home_computer meeting? 
6 transactions expunged 



yes 



forum: 



Note again that only deleted transactions can be expunged. 



Retrieving Participants and Transactions 

The "retrieve_participant" (rtpt) request retrieves a user's record of participation after 
you have deleted that record with the "delete_participant" request The user's record of 
participation is restored to the list of the meeting's participants. 

forum: ! rtpt Black 
forum: 



The "retrieve" (rt) request retrieves transactions that you have previously removed from 
the proceedings. You can retrieve a range of transactions, if necessary, but regular expressions 
and Person_ids can not be used as transaction specifiers with this request. To print a list of 
the deleted transactions in the current meeting, type "list -only_deleted". To retrieve 
transaction [0007], type: 

forum: ! rt 7 

forum: 

Now when you list the proceedings of the meeting, transaction [0007] appears in its original 
slot in the list and has been restored in its entirety to the meeting. 
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Setting a Message 

The "set_message" request allows you to enter a message that is printed each time a 
user enters the meeting or enters a transaction from elsewhere within Forum. You can also 
use this request to change the message that you have previously set. Some messages set by 
chairmen are greetings ("Welcome to the Television meeting") while other messages describe 
restrictions or warnings ("This is a developmental meeting open to Honeywell employees 
only"). The message has a maximum allowable size of 256 characters. 

Enter the meeting that you want to set a message in. If you have already entered the 
message into a segment, use the "-input_file pathname" control argument with "set_message" 
to set the message that is contained in that segment. Otherwise, type only "set_message", and 
Forum prompts you for the message, which you must end in one of the ways described for 
exiting from terminal input mode. 

If you have written your message into a segment named "greeting" you would set the 
message this way (assume that you are already attending the Television meeting): 

forum: ! set_message -if greeting 

Use the "enter" request to enter the message. 

forum: ! enter 

forum: 

The message has been set 

Suppose you want to build the message from within Forum: 

forum: ! set_message 

Message: 

! Welcome to the Television meeting. 

! This meeting is for discussing and rating 

! television shows shown at prime-time. 

! Please try to be as brief as possible. 

! . 

forum: 

Again, the message has been set. 

Printing Eligibility Messages 

The eligibility message for a meeting, as shown in Section 2, greets the user upon 
entrance to the meeting. Site administrators decide whether or not these messages are globally 
printed for all meetings on the system. If site administration turns them on globally, you 
(the chairman) can then either go along with the system-wide printing of these messages or 
turn printing off for the meeting that you chair. 
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The "switch_on" (swn) and "switch_off" (swf) requests accept the switchname 
"meeting_eligibility_messages" (mtg^emsg). To turn off printing of the message (only if your 
site administration has turned printing on), type: 

forum: ! swf mtg_emsg 

To turn printing back on, type: 

forum: ! swn mtg_emsg 



NAMING A NEW CHAIRMAN 

The chairman-of -record is the person who originally created the meeting. If you are 
the current chairman, you can use the "chairman" (cm) request with the -set control argument 
to change the chairman of the current meeting. Only the current chairman is allowed to pass 
on the chairmanship of the meeting to someone else. The new chairman must be specified by 
his/her Person_id.Project.jd, To change the chairman of the Accounting meeting (the current 
meeting) type: 

| forum: ! cm -set BMcElvenny.ProjA 

forum (chairman): Do you really want to change the chairman of the 
Accounting meeting to BMcElvenny.ProjA ! yes 

| forum: 



ADDING A CHAIRMAN 

Meetings created with the MRU (or later) version of forum can have more than one 
chairman. The chairman-of-record is the person who originally created the meeting and the 
one whose name is returned by the chairman request. 

To add an additional chairman to a meeting, use the forum_add_particiapnt (fapt) 
command with the -chairman control argument This allows the added participant to have 
chairman access to the meeting. To add the participant McElvenny and give him chairman 
access to the Accounting meeting, type: 

forum: ! fapt Accounting McElvenny -chairman 

McElvenny added to the Accounting meeting with chairman access 



| r 08:42 0.2i»7 66 
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You can also use the set_acl command to add an additional chairman to a meeting: | 

forum: i set_acl Accounting. forum rwc McElvenny i 

Additionally, you can use the fapt or the set_acl command to give a whole project chairman 
access. 



DELETING A MEETING 

If the reason for your meeting was a question that has been resolved, or was to discuss 
and prepare for an event that is now over, or in any event is no longer valid, you will want 
to delete your meeting Of course you will want to give reasonable notification to the 
participants of the meeting, perhaps through a transaction or by setting a message. The 
forum_delete (fdl) command deletes a meeting: 

! fdl home computers 
r 08:23 0.307 2 



PRE-MR11 FORUM MEETINGS AND CURRENT VERSION FORUM MEETINGS 

A forum meeting created with pre-MRll software consists of two storage system 
segments which contain records of the participants in the meeting and what has been said 
These meetings contain the suffixes ".control" or ".proceedings". A current version forum 
meeting (MRU or later) is created as a single segment with the suffix ".forum". The current 
version forum software supports both pre-MRll forum meetings and current version forum 
meetings. 

The meetings created with current version forum software are treated as entries within 
the Multics storage system. Since current version forum meetings are treated as such, you can 
use the standard file system commands such as copy, delete, list_acl, and set_acl. This support 
also alleviates limitations on the number of meeting attendees and transactions. Current 
version meetings have no easily relizable limit on the amount of information which they can 
contain. 

The current version forum also incorporates a new search strategy for locating forum 
meetings by looking in the forum list to find the meetings. Additionally, the current version 
forum meetings provide a "seen" flag for each transaction (in contrast with a pre-MRll 
meeting which only sets a single flag for the most recent transaction seen). 
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CONVERTING A MEETING 

Although the current version (MRU or later) of forum supports meetings created with 
pre-MRll software, there are several advantages to current version meetings (as described 
previously). 

Each site has been supplied with tools which will convert all pre-MRll meetings to 
current version meetings. If your site decides not to use these tools, each individual chairman 
can convert the pre-MRll meetings to current version meetings. The convert_forum command 
(described in Section 10) converts a pre-MRll meeting into a current version forum meeting. 
Only the chairman of the meeting can use this command. 

To ensure a smooth transition for meeting users, the chairman should perform the 
following actions before using the convert_forum command: 

1. Enter a transaction for meeting users explaining that the meeting will be 
converted to a current version meeting and all participants should use the 
"add_meeting_update" request (described in Section 7) to update their forum 
search list 

2. To prevent participants from entering any more transactions in the old meeting, 
you should use the add_participant, add_project or make_public request with 
the read_only control argument 

3. Once you have created the current version meeting with the convert_forum 
command, you should delete the old meeting using the forum_delete command 
described in Section 8. To avoid deleting the current version meeting you must 
Use the suffix ".control" after the meeting name. 
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SECTION 10 
CHAIRMAN COMMANDS 



The commands in this section are intended to be used only by the chairman, or 

maintainer, of the meeting. (For a step-by-step breakdown of the duties of a chairman,' see 
Section 9.) 

The descriptions of the Forum administrative commands are presented here in 

alphabetical order. Each description contains the name of the command (including the 
abbreviated form, if any), discusses the purpose of the command, and shows the correct 
usage. Notes and examples are included when deemed necessary for clarity. 
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forum_add_participant forum_add_participant 



Name: forum_add_participant, fapt 

SYNTAX AS A COMMAND 

fapt meet i ng_name Person_ld {-control_args} 

FUNCTION 

makes the person identified by Person_id eligible to attend the meeting_name meeting. You 
can use this request if you have either modify permision on the containing directory or 
chairman access to the meeting. 

ARGUMENTS 

meeting_name 

is the pathname or entryname of the meeting to be adjusted. Pathnames contain 
greater-than (>) or less-thin (<) characters. If a pathname is specified, it identifies the 
meeting to be adjusted. Otherwise, fapt searches for the meeting_name by using the 
forum search list 

Person_id 

is the Person_id of the participant to be added. 

CONTROL ARGUMENTS 

-chairman, -cm 

gives chairman access to the added participant This control argument is not valid for 
meetings created with pre-MRll software. 

-read_only, -ro 

allows the added participant to read transactions but not enter them. 

NOTES 

The -read_only and -chairman control arguments cannot both be specified. 

To change the access of a participant to read only, use the fapt command with the 
-read_only control argument to add the participant again. This will change the original access 
of the participant to read only. 

The meeting chairman can use the convert_forum command (described in "Chairman 
Commands" in this manual) to convert meetings created with pre-MRll software to current 
version meetings. The old version meeting is left untouched and should be deleted using the 
forum_delete command (described in "User Commands" in this manual). To avoid deleting the 
current version meeting, you must include the ".control" suffix at the end of the 
meeting_jiame. 
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forum_add_project forum_add_project 



Name: forum_add_project, fapj 

SYNTAX AS A COMMAND 

fapj meeting_name Project_id {-control_args} 

FUNCTION 

makes users from the project identified by Project_id eligible to attend the meeting_name 
meeting. 

ARGUMENTS 

meeting_name 

is the pathname or entryname of the meeting to be adjusted. Pathnames contain 
greater-than (>) or less-than (<) characters. If a pathname is specified, it identifies the 
meeting to be adjusted. Otherwise, fapj searches for the meeting_name by using the 
forum search list 

Projected 

is the Projected for the project to be admitted to the meeting. 

CONTROL ARGUMENTS 

-chairman, -cm 

gives chairman access to the added participant This control argument is not valid for 
meetings created with pre-MRll software. 

-read_only, -ro 

allows users on the added project to read transactions but not enter them. 

ACCESS REQUIRED 

You can use this request if you have either modify permision on the containing directory or 
chairman access to the meeting. 

NOTES 

The -read_only and -chairman control arguments cannot both be specified. 

To change the access of a project to read only, use the fapj command with the -read_only 
control argument to add the project again. This changes the original access to allow users on 
the project to read transacrions but not enter them. 
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forum_create forum create 



Name: forum__create, fcr 

SYNTAX AS A COMMAND 

fcr 

FUNCTION 



creates a new meeting with the user as chairman. It engages the user in a dialogue, 
prompting for all information necessary for the creation of a new meeting including long and 
short meeting names, participant information, and the first transaction in the meeting. 



NOTES 



See "Duties of the Chairman" in this manual for a detailed discussion, including a complete 
example showing the creation of a meeting with this command. 
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forum_make_public forum_make_public 



Name forum_make public, fmp 

SYNTAX AS A COMMAND 

fmp meeting_name {control_args} 

FUNCTION 

opens the meeting_name meeting to public participation. 

ARGUMENTS 

meeting_name 

is the pathname or entryname of the meeting to be made public. Pathnames contain 
greater-than (>) or less-than (<) characters. If a pathname is specified, it identifies the 
meeting to be made public. Otherwise, fmp searches for the meeting_name by using the 
forum search list 

CONTROL ARGUMENTS 

-chairman, -cm 

gives chairman access to the added participant. This control argument is not valid for 
meetings created with pre-MRll software. 

-read_only, -ro 

allows the public to read transactions but not enter them. 

ACCESS REQUIRED 

You can use this request if you have either modify permision on the containing directory or 
chairman access to the meeting. 

NOTES 

The -read_only and -chairman control arguments cannot both be specified. 
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forum_remove_participant forum_remove_participant 



Name forum__remove_participant, frpt 

SYNTAX AS A COMMAND 

frpt meeting_name Person_id 

FUNCTION 

makes the person identified by Person_id ineligible to attend the meeting_name meeting. 

ARGUMENTS 

meeting_name 

is the pathname or entryname of the meeting to be adjusted. Pathnames contain 
greater-than (>) or less-than (<) characters. If a pathname is specified, it identifies the 
meeting to be adjusted. Otherwise, frpt searches for the meeting_name by using the 
forum search list. 

Person_id 

is the Person_id of the user to be removed from participation in the meeting. 

ACCESS REQUIRED 

You can use this request if you have either modify permision on the containing directory or 
chairman access to the meeting. 

NOTES 

The -read_oniy and -chairman control arguments cannot both be specified. 
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forum_remove_project forum_remove_project 



Name forum remove project, f rpj 

SYNTAX AS A COMMAND 

frpj meeting_name Project_id 

FUNCTION 

denies eligibility to all participants who are currently eligible to attend by virtue of their 
project participation alone (not by virtue of their Person_id) from the meeting_name meeting. 

ARGUMENTS 

meeting_name 

is the pathname or entryname of the meeting to be adjusted. Pathnames contain 
greater-than (>) or less-than (<) characters. If a pathname is specified, it identifies the 
meeting to be adjusted. Otherwise, frpj searches for the meeting_name by using the 
forum search list. 

Projected 

is the Projected of the project whose members are to be denied participation rights if 
they lack explicit Person_id participation rights. 

ACCESS REQUIRED 

You can use this request if you have either modify permision on the containing directory or 
chairman access to the meeting. 
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forum_unmake_public forum_unmake_public 



Name: forum__unmake public, fump 

SYNTAX AS A COMMAND 
fump meet i ng_name 
FUNCTION 

removes all participants from the meeting_name meeting who are participating by virtue of 
the public attribute. All users who are not participating because of Projected or Person_id 
rights are removed, 

ARGUMENTS 

meeting_name 

is the pathname or entryname of the meeting to be adjusted. Pathnames contain 
greater-than (>) or less-than (<) characters. If a pathname is specified, it identifies the 
meeting to be adjusted. Otherwise, fump searches for the meeting_name by using the 
forum search list. 

ACCESS REQUIRED 

You can use this request if you have either modify permision on the containing directory or 
chairman access to the meeting 
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convert_forum convert forum 



Name: convert_forum 

SYNTAX AS A COMMAND 
convert_forum meeting_name 
FUNCTION 

converts a pre-MRll forum meeting to a current version forum meeting. The current version 
meeting is created in the same directory as the original meeting. All addnames and the access 
control list are copied. The convert_forum command does not delete the pre-MRll meeting. 

ARGUMENTS 

-meeting_name 

is the pathname or entryname of the meeting to be converted. Pathnames contain 
greater-than (>), or less-than (<) characters. If a pathname is specified, it identifies the 
meeting to be converted. Otherwise, the convert_forum searches for the meeting_name by 
using the forum search list 

ACCESS REQUIRED 

Only the chairman of the meeting can use this command. 
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APPENDIX A 
ADMINISTRATIVE INFORMATION 



System administrators can change the attributes of any meeting by the use of the 
forum_admin command. The forum_admin command provides the necessary administrative 
backup in the event a chairman is no longer able to function in that capacity, as well as the 
ability to determine system-wide policies regarding optional Forum features. 

In order to use Forum at a site, you must do a few things other than install the 
software and associated info segments. The central meeting directory and notifications database 
must be created, and there are several "customizing" features regarding access control that a 
site may want to change. 

INSTALLATION INSTRUCTIONS 



The Central Forum Directory 

This directory is the repository for public site-approved meetings. It is known to the 
forum software and is in the default "forum" search path. The pathname of the directory is 
>site>forum_dir. This directory should be created and given an ACL term of "s *.*.*" along 
with the "sma" ACL terms given to administrators entrusted with creating meetings there. 

If for some reason, a site wishes to use some other directory as the central directory, 
the following steps should be taken: 

1. Change the assignment of forum_external_data.central_directory in the segment 
forum_data_.cds to the desired path and recompile iL 

2. Initiate the new copy of forum_data_ and recompile the segment 
forum_search_list_default_.cds in bound_forum_.s.archive 

3. Update forum_search_list_default_ in bound_forum_.archive and rebind 
bound_forum_. 

4. Install the new source /object /executable versions of bound_forum_ and 
forum_data_. 
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The Site Meeting Directory 

This directory is a public meeting where users can place announcements about meetings 
of general interest It is located in the central forum directory and the pathname is 
>site>forum_dir>Meetings_Directory (this is the default and other pathnames are possible). 
The forum_create command and announce_meeting request both place meeting announcements 
in this meeting by default. 

Forum looks for a pre-MRll version meeting named Meetings_Directory.control. If 
your site has a public meeting of this type, but the meeting has a different name, you must 
update the forum_data_.cds segment by changing the assignment of the variable 
forum_external_data.meetings_directory. You can then recompile and install the new forum_data_. 
with the correct suffix (.control for a pre-MRll version meeting and .forum for a current 
version meeting). You must also follow the above steps if you convert your public meeting 
from a pre-MRll version meeting to a current version meeting or if you are a new site 
creating the meeting for the first time. 

The Notifications Database 

The Forum subsystem maintains a database of users who are currently accepting 
notifications of new transactions (see Section 4 for an explanation of notifications). This 
segment resides in the central forum directory and must be created before notifications can 
be used. An administrator who has access to the forum_admin_ gate should create this 
segment with the command: 

! forum_admin ini t_notifi cat ions 
(See the "Gate Access" below for information on the forum_admin_ gate.) 

Gate Access 

The Forum subsystem has two gates: forum_ and forum_admin_. The forum_ gate is 
essential to use the subsytem and should have its access set to "re *.*.*". 

The forum_admin_ gate is used to perform administrative functions for Forum and to 
perform chairman functions on meetings (such as changing access and changing the chairman) 
by users other than the chairman of those meetings. This is a highly-privileged gate. The 
default access to this gate is "re *.SysMainL* null *.*.*". 



A-2 CT74-02 



Eligibility Messages 

in otusr to keep participants iihormcu Oi tne auuience of a particular meeting, Forum 
provides an optional facility that tells participants how many projects and users may read a 
meeting, and warns the participant each time the access to the meeting changes. The chairman 
of the meeting normally invoices this facility, but it can be manipulated by users with access 
to the forum_admin_ gate as follows. The command: 

! forum_admin switch_on print_el igibil i tyjnessages 

will cause Forum to print eligibility messages for every meeting on the system unless 
specifically exempted by the following two switches. 

The command: 

! forum_admin switch_on chai rman_set_el igibl 1 i ty_msgs 

allows the chairman to turn eligibility messages off even if the print_eligibility_messages 
switch is on, and the command: 

! forum_admin switch_(on off) meeting_el igibi 1 i tyjnessages PATH 

will turn eligibility messages for the meeting identified by PATH on or off regardless of the 
setting of the system-wide switches. 

AIM 

Forum is a single-class AIM facility. Meetings are single-class storage system objects. 
All participants must be logged in at the same authorization, which must be the access class 
of the meeting. Different meetings, however, may be at different access classes. The access 
class of a meeting is the authorization of the chairman at the time the meeting was created. 
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forum.admin forum_admin 



Name fonun_adniiiJ 

SYNTAX AS A COMMAND 

forum_admin key {arguments} 

FUNCTION 

allows system administrators to change attributes of meetings that they do not chair. This 
command is also used to perform certain administrative functions such as initializing the 
forum notifications database. 

ARGUMENTS 

key 

is any key described below in "List of Keys." 

arguments 

are the arguments for individual keys described below. 

LIST OF KEYS 



change_chairman path new_chairman 

displays the User_id of the current chairman of the meeting whose pathname is "path" 
and then shifts the chairmanship to new_chairman. new_chairman must be of the form 
Person_id.Project_id. 

convert path 

converts the meeting whose pathname is "path" from a pre-MRll version meeting to a 
current version meeting. 

delete path 

deletes the meeting whose pathname is "path". 

init_notifications 

creates an empty notifications database segment in the central forum directory. 



switch_off switchname, swf switchname 

turns the specified switch off. See "List of Switches" below. 

switch_on switchname, swn switchname 

turns the specified switch on. See "List of Switches" below. 
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forum.admin forum.admin 



LIST OF SWITCHES 

adjourned path, adj path 

temporarily adjourns the meeting specified by path. When this switch is on, no users 
may enter the meeting. 

chairman_set_eligibility_msg, cm_set_emsg 

allows the chairman to override the print_eligibility_messages switch. 

meeting_eligibility_messages path, mtg_emsg path 

turns on eligibility messages for the meeting named by "path". 

print_eligibility_messages, pemsg 

turns on eligibility messages for all meetings on the system. 

ACCESS REQUIRED 

This command requires access to the forum_admin_ gate. In addition, the convert, delete and 
access-changing keys require at least "m" access to the directory containing the meeting as 
does setting a switch on a meeting if access must be forced. Setting global switches requires 
rw access to forum_data_, and the init.notifications key requires "sma" access to the central 
forum directory. 
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APPENDIX B 
SUBROUTINE DESCRIPTIONS 
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forum_ forum_ 



Name; foreim 

The forum_ subroutine provides a subroutine interface to the Forum interactive meeting 
system. 

Entry: forum_$accept notifications 

This entry turns on reception of forum notifications by the calling process. 

USAGE 

declare forum_$accept_notif i cat ions entry (fixed bin (35)); 

call forum_$accept_notif ications (status); 

ARGUMENTS 

status 

is a standard status code. (Output) It can have the following value: 

forum_error_table_$no_notify_seg 

The notifications database could not be initiated. 

Entry: forum $change_chairman 

This entry is used to change the chairman of a Forum meeting. 

USAGE 

declare forum_$change_chairman entry (char (*) , char (*) , char (*) , fixed 
bin (35)); 

call forum_$change_chairraan (dirname, entryname, chairman, status); 

ARGUMENTS 

dirname 

is the pathname of the directory containing the meeting. (Input) 

entryname 
( is the name of the meeting. The ".forum" suffix is required. (Input) 

chairman 

is the name of the new chairman of the meeting, in the form PersomProjecL The new 
chairman must already be a participant (Input) 






forum forum. 



status 

is a standard status code. (Output) It can have one of the following values: 

forum_error_table_$chairman_only 

The caller is not the current chairman. 

forum_error_table_$no_such_user 

The supplied new chairman is not a participant 

Entry: forum_$change__chairman__idx 

This entry changes the chairman of a Forum meeting. It is the same as the change_chairman 
entry point except that a forum_idx is used to identify the meeting instead of a pathname. 

USAGE 

declare forum_$change_chai rman_idx entry (fixed bin, char (*) , 
fixed bin(35)); 

call forum_$change_chai rman_idx (forum_Jdx, chairman, status); 

ARGUMENTS 

forum_idx , 

identifies a meeting opened by forum_$open_forum. (Input) 

chairman 

is the name of the new chairman of the meeting, in the form Person.ProjecL The new 
chairman must already be a participant. (Input) 

status 

is a standard status code. (Output) It can have one of the following values: 

forum_error_table_$chairman_only 

The caller is not the current chairman. 

forum_error_table_$no_such_user 

The supplied new chairman is not a participant 
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forum - forum. 

Entry: forum_$chname_forum 

This entry is used to change the names of Forum meetings. 
USAGE 

declare forum_$chname_forum entry (char (*) , char (*) , char (*) , char (*) , fixed 
bin (35)) ; 

call forum_$chname_forum (dirname, entryname, old_name, new_name, status); 

ARGUMENTS 

dirname 

is the pathname of the directory containing the meeting. (Input) 

entryname 
| is the name of the meeting. The ".forum" suffix is required. (Input) 
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forum_ forum 



old_name 

is a name to be removed from the meeting, or blank if no name is to be removed. If 
non-blank, ".forum" suffix is required. (Input) 

new_name 

is a name to be added to the meeting, or blank if no name is to be added. If 
non-blank, the ".forum" suffix is required. (Input) 

status 

is a standard status code. (Output) 

Entry: forum_$chname__forum_idx 

This entry is used to change the names of Forum meetings. It is the same as the 
chname_forum entry point except that a forum_idx is used to identify the meeting instead of 
a pathname. 

USAGE 

declare forum_$chname_forum idx entry (fixed bin, char (*) , char ('V) , fixed 
bin (35)) ; 

call forum_$chname_forum_idx (forum_idx 5 old_name s new name, status); 

ARGUMENTS 

forum_idx 

identifies a meeting opened by forum_$open_forum. (Input) 

old_name 

is a name to be removed from the meeting, or blank if no name is to be removed. If 
non-blank, the ".forum" suffix is required. (Input) 

new_name 

is a name to be added to the meeting, or blank if no name is to be added. If 
non-blank, the ".forum" suffix is required. (Input) 

status 

is a standard status code. (Output) 
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forum_ forum_ 

Entry: forum_$create_forum 

Creates a Forum meeting with the user as chairman. 

USAGE 

declare forum_$create_forum entry (char (*) , char (*) , fixed bin (35)); 

call forum_$create_forum (dirname, entryname, status); 

ARGUMENTS 

dirname 

is the pathname of the directory containing the meeting. (Input) 

entryname 
| is the name of the meeting. The ".forum" suffix is required. (Input) 

status 

is a standard status code. 

ACCESS REQUIRED 

The caller must have modify permission on the containing directory. 

Entry: forum_$set vl_forum_acl 

This entry is valid only for meetings created with pre-MRll software. This entry is used to 
add or change an ACL term. ACL terms can only be specified for Person_id.* or 
*.Project_id, terms of the form Person_id.Project_id are not allowed. 

USAGE 

declare forum_$set_vl_forum_acl entry (fixed bin, char (*) , bit(l) aligned, 
bit(l) aligned, bi t (if aligned, fixed bin (35)) ; 

call forum_$set_vl_forum_acl (forum_idx, access_name, user_sw, set_sw, 
write_sw, status); 

ARGUMENTS 

forum_idx 

identifies a meeting opened by forum_$open_forum. (Input) 

access_name 

The Personjd or Projected whose ACL is to be added or deleted. Access_name can not 
contain a ".". (Input) 
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forum_ forum 



user_sw 

This switch should be on if access_name is a Person_id, and off if it is a Projected. 
(Input) 

set_sw 

This switch should on if access is to be added, and off if it is to be deleted. (Input) 

write_sw 

This switch should on if write access is to be added, and off if only read access is to 
be added. This switch is ignored if set_sw is off. (Input) 

status 

is a standard status code. (Output) 

ACCESS REQUIRED 

The caller must have modify permission on the containing directory. 

Entry: forum__$vl_expunge 

This entry is used to physically remove deleted participant records and deleted transactions 
from a Forum meeting. This results in reclaimed storage space. 

USAGE 

declare forum_$vl_expunge entry (fixed bin, bit (36) aligned, fixed bin, fixed | 
bin, fixed bin, fixed bin, fixed bin (35)); 

call forum_$vl_expunge (forum_idx, switches, users_deleted, trans_deleted, | 

users_damaged, trans_damaged, status) ; 

ARGUMENTS 

forum_idx 

identifies a meeting opened by forum_$open_forum. (Input) 

switches 

is a word of switches as follows: (Input) 

transactions 

if set, deleted transactions should be expunged. 

users 

if set, deleted participant records should be expunged. 

users_deleted 

is the number of participant records which were expunged. (Output) 
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forum - forum 



trans_deleted 

is the number of transactions which were expunged. (Output) 

users_damaged 

is the number of participant records which were expunged because they were inconsistent. 
(Output) 

trans_damaged 

is the number of transactions which were expunged because they were inconsistent 
(Output) 

status 

is a standard status code. (Output) 

Entry: forum_$check_user 

This entry is used to determine if a user is a participant in a Forum meeting. 
USAGE 

declare forum_$check_user entry (fixed bin, char (*) , fixed bin, fixed 
bin (35)) ; 

call forum_$check_user (forum_idx, user_name, last_entered, status); 

ARGUMENTS 

forum_idx 

identifies a meeting opened by forum_$open_forum. (Input) 

user_name 

The Person_id of the user to be checked. (Input) 

last_entered 

is the index of the most recent transaction entered by this user, or if this user has 
never entered a transaction. (Output) 

status 

is a standard status code. (Output) 
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forum_ forum_ 

Entry: forum_$close_forum 

This entry closes a meeting opened by forum_$open_forum. 

USAGE 

declare forum_$close_forum entry (fixed bin, fixed bin(35)); 

call forum_$close_forum (forum_idx, status); 

ARGUMENTS 

forum_idx 

identifies a meeting opened by forum_$open_forum. This argument will be set to zero if 
the meeting is successfully closed. (Input/ Output) 

status 

is a standard status code. It can have the following value: 

forum_error_table_$invalid_forum_idx 

forum_idx does not identify an open meeting. 

Entry: forum_$convert 

This entry converts a meeting created with pre-MRll software into a current version meeting. 

USAGE 

declare forum_$convert entry (char (*) , char (*) , fixed bin (35)); 

call forum_$convert (dirname, entryname, status); 

ARGUMENTS 

dirname 

is the name of the directory containing the meeting. (Input) 

entryname 

is the name of the meeting. (Input) The ".control" suffix is required. 

status 

is a standard status code. 

ACCESS REQUIRED 

The caller must have modify permission on the containing directory and chairman access to 
the meeting. 
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forum_ forum_ 

Entry: foMim__$convert__tte_dee__idx 

This entry is used to convert an attendee_idx into a user name. 

USAGE 

declare forum_$convert attendee_idx entry (fixed bin, fixed bin, char (*) , 
fixed bin(3S)) ; 

call forum_$convert_attendee_idx (forum_idx, attendee_idx, user_name, status); 

ARGUMENTS 

forum_idx 

identifies a meeting opened by forum_$open_forum. (Input) 

attendee_idx 

is the index of a participant in a meeting, as placed in Forum interprocess messages. 
(Input) 

user_name 

is the name of the user with the specified attendee_idx, in the form Person_id.Project._id. 
(Output) 

status 

is a standard status code. (Output) It can have the following value: 

forum_error_table_$invalid_attendee_idx 

The supplied attendee index does not correspond to a valid participant record in this 
meeting. 

Entry: fonim_JWelete_Jorum 

Deletes a Forum meeting. 

USAGE 

declare forum_$de1ete_forum entry (char (*) , char (*) , fixed bin(35)); 

call foru«i_$delete_forum (dirname, entryname, status); 

ARGUMENTS 

dirname 

is the pathname of the directory containing the meeting. (Input) 

entryname 

is the name of the meeting. The ".forum" suffix is required. (Input) 
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status 

is a standard status code. (Output) 

ACCESS REQUIRED 

The user must have modify permission on the containing directory. 

Entry: forum_$delete_forum_acl | 

This entry deletes specified entries from an access control list (ACL). This entry cannot be 
used on meetings created with pre-MRll software. 

USAGE 

declare forum_$delete_forum acl entry (char (*) , char {*) , ptr, fixed bin, fixed 
bin (35)); 

call forum_$delete_forum_acl (dirname, entryname, acl_ptr, acl_count, code); | 

ARGUMENTS | 

dirname 

is the pathname of the directory containing the meeting. (Input) 



entryname 

is the name of the meeting. The ".forum" suffix is required. (Input) 

acl_ptr 

points to a user-filled delete_acl structure (see "Notes" below). (Input) 

acl_count 

is the number of ACL entries in the delete_acl structure (see "Notes" below). (Input) 

code 

is a storage system status code. (Output) 

The following is the delete_acl structure: 

del 1 delete_acl (acl_count) aligned based (acl_ptr) , 
2 access_name char (32) s 

2 status_code fixed bin(35); 

STRUCTURE ELEMENTS 



access_name 

is the access name (in the form of Person_id.Project_id.lag) that identifies the ACL entry 
to be deleted. 
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status_code 

is a storage system status code for this ACL entry only. 

If code is returned as error_table_$argerr, then the erroneous ACL entries in the 
delete_acl structure have status_code set to an appropriate error code. No processing is 
performed. 

If an access name cannot be matched to a name already on the ACL of the segment, 
then the status_code for that ACL entry in the delete_acl structure is set to 
error_table_$user_not_found. Processing continues to the end of the delete_acl structure 
and code is returned as 0. 

Entry: forum__$enter__trans 

This entry is used to enter a transaction into a Forum meeting 
USAGE 

declare forum_$enter_trans entry (fixed bin, char (*) , fixed bin, char (*) , 
bit(1) aligned, fixed bin, fixed bin(35)); 

call forum_$enter_trans (forum_idx, text, previous_trans, subject, filled sw, 
trans_idx, status) ; 

ARGUMENTS 

forum_idx 

identifies a meeting opened by forum_$open_forum. (Input) 

text 

is the text of the transaction to be entered. (Input) 

previous_trans 

is the index of the transaction that this transaction is in reply to, or if it is the start 
of a new chain. (Input) 

subject 

is the subject of the transaction to be entered. (Input) 

filled_sw 

is set if the transaction should not be filled on output (Input) 

trans_idx 

is the index of the transaction entered. (Output) 

status 

is a standard status code. (Output) It can have the following value 

f orum_error_table_$read_only 

The caller does not have access to enter transactions in the meeting. 
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Entry: forum_$expunge 

This entry is used to physically remove deleted participant records and deleted transactions 
from a Forum meeting. This results in reclaimed storage space. 

USAGE 

declare forum_$expunge entry (fixed bin, bit (36) aligned, fixed bin, fixed 
bin) ; 

call forum_$expunge (forum_idx, switches, users_deleted, trans_deleted) ; 

ARGUMENTS 

forum_idx 

identifies a meeting opened by forum_$open_forum. (Input) 

switches 

is a word of switches as follows: (Input) 
transactions if set, deleted transactions should be expunged, 
users if set, deleted participant records should be expunged. 

users_deleted 

is the number of participant records which were expunged. (Output) 

trans_deleted 

is the number of transactions which were expunged. (Output) 

status 

is a standard status code. (Output) 

Entry: forum_$forum_info 

This entry is used to obtain information about a Forum meeting. 
USAGE 

declare forum_$forum_info entry (char (ft) , char (*) , char (ft) , fixed bin (71). 
ptr, fixed bin(35)); 

call forum_$forum_info (dirname, entryname, access_name, access_time, 
forum_info_ptr, status); 

ARGUMENTS 

dirname 

is the pathname of the directory containing the meeting. (Input) 

entryname 

is the name of the meeting. The ".forum" suffix is required. (Input) I 
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access_name 

is the Person_id.Project_id.tag for which access is to be calculated. If blank, the 
access_name of the caller is used. The per-user information returned is for the 
Person_id portion of access_name. (Input) 

access_time 

changed information is calculated from the specified date-time. Usually, "clock ()" should 
be passed. (Input) 

forum_info_ptr 

is a pointer to a copy of the forum_info structure described below. (Input) 

status 

is a standard status code. (Output) It can have the following value: 

forum_error_table_$not_eligible 

The user does not have access to obtain information about transaction counts and 
changes, but the chairman name is still valid in this case. 

NOTES 

The forum_info structure is declared in the include file forum_info.incl.pll and has the 
following structure: 



del 1 



forum_info 


al igned based { 


forum_info_ptr) , 


2 version 


fixed bin, 




2 forum_uid 


bit (36), 




2 chairman 


unal igned, 




3 username 


char (20) , 




3 project 


char (9) . 




3 pad 


char (3) , 




2 attendee_count 


fixed bin, 




2 removal_count 


fixed bin, 




2 transact ion_count 


fixed bin, 




2 deletion_count 


fixed bin, 




2 last_seen_trans_idx 


fixed bin, 




2 last_time_changed 


fixed bin(7D , 




2 last_time_attended 


fixed bin (71) , 




2 changes_count 


fixed bin, 




2 flags 


unal igned, 




3 eligible 


bit(l), 




3 rnbzl 


bit(l), 




3 removed 


bit(l), 




3 notify 


bit(l), 




3 attending 


bit(l), 




3 mb22 


bit(2), 




3 read_only 


bit(l), 




3 adjourned 


bit(l), 




3 mbz3 


bit (27); 





B-14 



CY74-02 



forum. forum 



STRUCTURE ELEMENTS 

version 

is the version number of this structure. This must be set to the constant f orum_inf o_version_l, 
which is declared in the include file. 

forum_uid 

is the unique identifier of the meeting. 

username 

is the Person_id of the chairman of the meeting. 

project 

is the Projected of the chairman of the meeting. 

pad 

is unused. 

attendee_count 

is the total number of participants in the meeting. 

removal_count 

is the number of participant records marked as deleted. 

transaction_count 

is the total number of transactions entered before access_time, 

deletion_count 

is the number of those transactions that have been deleted. 

last_seen_trans_idx 

is the number of the most recently entered transaction that has been read by this user. 

last_time_changed 

is the time the most recent transaction was entered. 

last_time_attended 

is the time that the user last attended the meeting. 

changes_count 

is the number of transactions entered since access_time that the user has not seen. 

eligible 

is set if the user is eligible to attend the meeting. 

mbzl 

is unused. 

removed 

is set if the user has turned off the participating switch. 
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notify 

is set if the user has turned on the notify. 

attending 

is set if the user is currently attending the meeting. 

mbz2 

is unused. 

read_only 

is set if the user may not enter transactions in the meeting. 

adjourned 

is set if the chairman has adjourned the meeting. 

mbz3 

is unused. 

Entry: forum_$forum_info_idx 

This entry is used to obtain information about a Forum meeting. It is the same as the 
forum_info : entry point except that a forum_idx is used to identify the meeting instead of a 
pathname. 

USAGE 

declare forum_$forum_info_idx entry (fixed bin. char (*) , fixed bi n (71) , ptr. 
fixed bin (35)); " 

call forum_$forum_info_idx (forum_idx, access_name, access_time, 
forum_info_ptr , status); 

ARGUMENTS 

forum_idx 

identifies a meeting opened by forum_$open_forum. (Input) 

access_name 

is the Person_id.Project_id.tag for which access is to be calculated. If blank, the 
access_name of the caller is used. The per-user information returned is for the 
Person_id portion of access_name. (Input) 

access_time 

changed information is calculated from the specified date-time. Usually, "clock 0" should 
be passed. (Input) 

forum_info_ptr 

is a pointer to a copy of the forum_info structure described under the forum_$forum_info 
entry point (Input) 
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status 

is a standard status code. (Output) It can have the following value: 

forum_error_table_$not_eligibie 

The user does not have access to obtain information about transaction counts and 
changes, but the chairman name is still valid in this case. 

Entry: forum_$forum_limits 

This entry is used to obtain various pieces of information about an open Forum meeting. 
This entry point is obsolete. The forum_$real_forum_limits entry point should be used 
instead. 

USAGE 

declare forum_$forum_l imits entry (fixed bin, fixed bin, fixed bin, fixed bin, 
fixed bin, bi t (36) aligned, fixed bin(35)); 

call forum_$forum_l imi ts (forum_idx, last_seen, first_trans, last_trans, 
new_trans_count, flags, status) ; 

ARGUMENTS 

forum_idx 

identifies a meeting opened by forum_$open_forum. (Input) 

last_seen 

is the index of the most-recently entered transaction that the user has seen, as set by 
foruffl_$set_last_seen_id-x. (Output) 

first_trans 

is the index of the oldest transaction in the meeting. (Output) 

last_trans 

is the index of the most recent transaction in the meeting. (Output) 

new_trans_count 

is the number of transactions entered since last_seen by users other than the caller. 
(Output) 

flags 

is a collection of switches as described below. (Output) 

status 

is a standard status code. (Output) 
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NOitS 

The flags argument is declared in forum_flags.incl.pll and has the following strucure: 

del 1 forum_f lags al igned based (addr (forum flags_word) ) , 

2 chairman bit(l) unaligned, 

2 read_only bit(l) unaligned, 

2 print_cm_message bit(l) unaligned, 

2 print_acl_message bit(l) unaligned, 

2 acl_has_changed bit(l) unaligned, 

2 adjourned bit(l) unaligned, 

2 mb2 bit (30) unaligned; 

STRUCTURE ELEMENTS 

chairman 

is set if the user is the chairman of the meeting. 

read_only 

is set if the user may not enter transactions in the meeting. 

print_cm_message 

is set if the chairman message has changed since the last time the user saw it. 

print_acl_message 

is set if the access eligibility message should be printed. 

acl_has_changed 

is set if the access to the meeting has changed since the last time the user was informed 
that it had changed. 

adjourned 

is set if the chairman has adjourned the meeting. 

mbz 

is not used. 

Entry: forum_$get_forum_path 

This entry is used to determine the actual name of the meeting instead of the name of the 
link used to access it 

USAGE 

declare forum_$get_forum_path entry (char (*) , char (*) , char (*) , char (*) . 
fixed bin(35)); 

call forum_$get_forum_path (dirname, entryname, forum_dirname, 
forum_entryname, status) ; 
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ARGUMENTS 

dirname 

is the pathname of the directory containing the meeting. (Input) 

entryname 

is the name of the meeting. The ".forum" suffix is required. (Input) 

forum_dirname 

is the pathname of the directory where the meeting actually resides, (Output) 

forum_entryname 

is the primary name of the meeting. (Output) 

status 

is a standard status code. (Output) 

Entry: forum_$get_forum_path idx 

This entry is used to determine the actual name of the meeting instead of the name of the 
link used to access it It is the same as the get_forum_path entry point except that a 
forum_idx is used to identify the meeting instead of a pathname. 

USAGE 

declare forum_$get forum_path_idx entry (fixed bin, char (*) , char (*) , 
fixed bin (35)) ; 

call forum_$get_forum_path_idx (forum_idx, forum_dirname, forum_entryname, 
status) ; 

ARGUMENTS 

forum_idx 

identifies a meeting opened by forum_$open_forum. (Input) 

forum_dirname 

is the pathname of the directory where the meeting actually resides. (Output) 

forum_entryname 

is the primary name of the meeting (Output) 

status 

is a standard status code. (Output) 
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Entry: forum__$get message 

This entry is used to read out the greeting message set by the chairman using the 
forum_$set_message entry. 

USAGE 

declare forum_$get_message entry (fixed bin, char (*) , fixed bin (35)); 

call forum_$get_message (forum_idx, message, status); 

ARGUMENTS 

forum_Jdx 

identifies a meeting opened by forum_$open_forum. (Input) 

message 

is the text of the message, this can contain at most 256 characters. (Output) 

status 

is a standard status code. (Output) It can have the following value: 

forum_error_table_$no_message 

There is no chairman greeting message for this meeting. 

Entry: forum $get switch 

This entry is used to return the value of several switches associated with a Forum meeting or 
its participants. 

USAGE 

declare forum_$get_swi tch entry (char (*) , char (ft), char (*) , char (*) , bit 
(1) aligned, fixed bin (35)); 

call forum_$get_switch (dirname, entryname, person_id, swi tch_name, 
swi tch_setting, status); 

ARGUMENTS 

dirname 

is the name of the directory containing the meeting. (Input) 

entryname 

is the name of the meeting. The ".forum" suffix is required. (Input) 

person_id 

the user name of the user whose per-user switch value is desired. (Input) The projected 
should not be given. Starnames are not permitted. If this is blank, the current user is 

assumed. 
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switch_name 

is the name of the switch to retrieve. (Input) See "List of Switches" below. 

switch_setting 

is the returned switch setting. (Output) 

status 

is a standard status code. It may have the following value: 

forum_error_table_$inval id_swi tch_name 

the switch_name is not one of the valid switches. 

LIST OF SWITCHES 



adjourned, adj 

prevents users from entering the meeting. 

meeting_eligibility_messages, mtg_emsg 

turns on printing of eligibility messages for this meeting. 

notify, nt 

turns on the notify switch for the meeting. This means that an interactive message will 
be sent each time a transaction is entered if the user is logged in and has issued the 
forum_accept_notifications command. 

participating, part 

turns on the participation switch for the meeting. 

safety 

changes the storage system safety switch for the meeting. The meeting cannot be deleted 
if this switch is on. 

Entry: forum $get transaction map 

This entry is used to retrieve a bit map representing the transactions that a given participant 
has seen. This entrypoint cannot be used with meetings created with pre-MRll software. 

USAGE 

declare forum_$get_transaction_map entry (char (*) , char (*) , char (*) , bit 
(*) , f i xed bin (35) ) ; 

call forum_$get_transaction_map (dirname, entryname, person_id, seenjnap, 
status) ; 
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dirname 

is the name of the directory containing the meeting. (Input) 

entryname 

is the name of the meeting. (Input) The ".forum" suffix is required. 

person_id 

The username of the user whose transaction seen map is desired. (Input) Starnames are 
not permitted. If this is blank, the current user is assumed. 

seen_map 

is a bit map indicating which transactions the user has seen. If the n'th bit in this map 
is a "l"b, then the user has seen transaction "n". This variable must be large enough to 
hold one bit for each transaction in the meeting. 

status 

is a standard status code. 

Entry: forum_$get_uid_file 

This entry returns the file system unique identifier of a meeting. 
USAGE 

declare forum_$get_uid_f i le entry (char (*) , char (*) , bit (36) aligned, fixed 
bin (35)); 

call forum_$get_uid_f i le (dir_name, entryname, uid, code); 

ARGUMENTS 

dirname 

is the pathname of the directory containing the meeting. (Input) 

entryname 

is the name of the meeting. (Input) The meeting suffix is required. 

uid 

is the unique identifier of the meeting. (Output) 

code 

is a standard status code. 
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Entry: forum_$list_forum_acl 

This entry is used either to list the entire access control list (ACL) meeting or to return the 
access modes of specified ACL entries. This entry cannot be used with meetings created with 
pre-MRll software. 

USAGE 

declare forum_$list_forum_acl entry (char (*) , char (*) , ptr, ptr, ptr, fixed 
bin, fixed bin (35)) ; 

call forum_$l ist_forum_acl (dir_name, entryname, area_ptr, area ret ptr, 
acl_ptr, acl_count, code); ~ ~ 

ARGUMENTS 

dirname 

is the pathname of the directory containing the meeting. (Input) 

entryname 

is the name of the meeting. (Input) The ".forum" suffix is required. 

area_ptr 

points to an area in which the list of ACL entries, which make up the entire ACL of 
the segment, is allocated. (Input) If area_ptr is null, then the user wants access modes 
for certain ACL entries; these will be specified by the structure pointed to by acl_ptr. 

area_ret_ptr 

points to the start of the allocated list of ACL entries. (Output) 

acl_ptr 

if area_ptr is null, then acl_ptr points to an ACL structure, segment_acl, into which 
mode information is placed for the access names specified in that same structure. (Input) 
The segment_acl structure is described in the forum_$set_forum_acl entry point. 

acl_count 

is the number of entries in the ACL structure. (Input or Output) Input is the number 
of entries in the ACL structure identified by acl_ptr. 

Output is the number of entries in the segment_acl structure allocated in the area 
pointed to by area_ptr, if area_ptr is not null. 

code 

is a storage system status code. (Output) 

NOTES 

If acl_ptr is used to obtain modes for specified access names (rather than for all access 
names on a segment), then each ACL entry in the segment_acl structure either has status_code 
set to and contains the segment's mode or has status_code set to error_table $user not found 
and contains a mode of 0. ~ ~ 
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Entry: forum Siist vi_forum_aci 

This entry is used to list the ACL of a Forum meeting. 

USAGE 

declare forum_$l ist_vl_forum_acl entry (char (*) , char (*) , ptr, ptr, fixed bin, 
f i xed bin (35) ) ; 

call forum_$l ist_vl_forum_acl (dirname, pathname, area_ptr, acl_ptr, 
acl_count, status) ; 

ARGUMENTS 

dirname 

is the pathname of the directory containing the meeting. (Input) 

entryname 

is the name of the meeting. The ".forum" suffix is required. (Input) 

area_ptr 

points to an area where the segment_acl structure is to be allocated. (Input) It can not 
be null. 

acl_ptr 

points to the allocated segment_acl structure. This structure is described in the 
hcs_$add_acl_entries subroutine. (Output) 

acl_count 

is the number of ACL entries in the segment_acl structure. (Output) 

status 

is a standard status code. (Output) 

Entry: forum Slist users 

This entry is used to extract information about the participants in a Forum meeting. 

USAGE 

declare forum_$1 ist_users entry (char (*) , char (*) , ptr, ptr, fixed bin (35)); 

call forum_$l ist_users (dirname, entryname, area_ptr, user_l ist_ptr, status); 

ARGUMENTS 

dirname 

is the pathname of the directory containing the meeting. (Input) 
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entryname 

is the name of the meeting. The ".forum" suffix is required. (Input) 

area_ptr 

is a pointer to an area where the userjist structure is to be allocated. (Input) It can 
not be null. 



user_list_ptr 

is a pointer to the userjist structure described below. (Output) 

status 

is a standard status code. (Output) 

NOTES 

The userjist structure is declared in the include file fQrum_user_list.incl.pll and has the 
following structure: 

del 



1 user_l ist 


based (user_l ist_ptr) aligned, 


2 version 


fixed bin, 


2 chairman 


al igned, 


3 person_id 


char (22) unal igned, 


3 project_id 


char (9) unaligned, 


2 transact ion_count 


fixed bin, 


2 no_attendees 


fixed bin, 


2 attendee 


(user_l ist_no_attendees 




refer (user_l ist. no_attendees) ) , 


3 person_id 


char (22) unal igned, 


3 project_id 


char (11) unaligned, 


3 attending 


b i t ( 1 ) una I i gned , 


3 mbzl 


bit (2) unal igned, 


3 notify 


bit (1) unal igned, 


3 removed 


bit(l) unaligned, 


3 read only 


bit(l) unaligned, 


3 mbz2~ 


bit (3) unaligned, 


3 1 as t_time_at tended 


fixed bin(7D , 


3 highest_trans_seen 


fixed bin; 



STRUCTURE ELEMENTS 

version 

is the version number of this structure. Currently, this is set to the constant 
user_list_version_l which is also declared in the include file. 

person_id 

is the Person_id of the chairman of the meeting. 

projected 

is the Projected of the chairman of the meeting. 
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transaction_count 

is the total number of transactions in the meeting. 

no_attendees 

is the total number of non-deleted participants in the meeting. 

person_id 

is the Person_id of this participant 

projected 

is the Projected of this participant. 

attending 

is set if this participant is currently attending the meeting. 

mbzl 

is not used. 

notify 

is set if this participant has requested notifications. 

removed 

is set if this participant has turned off the participating switch. 

read_only 

is set if this user may not enter transactions in the meeting. 

mbz2 

is not used. 

last_time_attended 

is the time the participant last attended the meeting. 

highest_trans_seen 

is the index of the most-recently entered transaction that the user has read. 

Entry: forum_$list_users_idx 

This entry is used to extract information about the participants in a Forum meeting. It is the 
same as the list_users entry point except that a forum_idx is used to identify the meeting 
instead of a pathname. 

USAGE 

declare forum_$l ist_users_idx entry (fixed bin, ptr, ptr, fixed bin(35)); 

call forum_$1 ist_users_idx (forum_idx, area_ptr, user_l ist_ptr, status); 
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ARGUMENTS 

forum_idx 

identifies a meeting opened by forum_$open_forum. (Input) 

area_ptr 

is a pointer to an area where the user_list structure is to be allocated. (Input) It can 
not be null. 

user_list_ptr 

is a pointer to the user_list structure described under the forum_$list_users entry point. 
(Output). 

status 

is a standard status code. (Output) 

Entry: forum_$open forum 

This entry opens a meeting and returns the forum_idx used in many of the other calls to 
forum_. 

USAGE 

declare forum_$open_forum entry (char (*) , char (*) , fixed bin, fixed bin (35)); 

call forum_$open_forum (dirname, entryname, forum_idx, status); 

ARGUMENTS 

dirname 

is the pathname of the directory containing the meeting. (Input) 

entryname 

is the name of the meeting. The ".forum" suffix is required. (Input) 

forum_idx 

is the index number used in subsequent calls to forum_ that take a forum index. All 
coexistent openings of the same meeting in the same process will return the same 
number. (Output) 

status 

is a standard status code. If this is non-zero the meeting could not be opened. (Output) 
It can have one of the following values: 

forum_error_table_$meeting_adjoumed 

The chairman has adjourned the meeting. Only the chairman can attend. 

forum_error_table_$no_such_forum 

The dirname-entryname pair does not exist 
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forum_erTor^table_$not_a_forum 

The segment named by dirname and entryname is not a Forum meeting. 

forum_error_table_$not_eligible 

The caller has insufficient access to participate in the meeting. 

Entry: forum_$read_trans 

This entry is used to read a transaction from a Forum meeting. 

USAGE 

declare forum_$read_trans entry (fixed bin, fixed bin, ptr, ptr, 
fixed bin(35)) ; 

call forum_$read_trans (forum_idx, trans_idx, area_ptr, forum_user_trans_ptr , 
status) ; 

ARGUMENTS 

forum_idx 

identifies a meeting opened by forum_$open_forum. (Input) 

trans_idx 

is the index of the transaction to be read. (Input) 

area_ptr 

is a pointer to an area where the forum_user_trans structure is to be allocated. (Input) 

forum_user_trans_ptr 

is a pointer to the forum_user_trans structure described below. (Output) 

status 

is a standard status code. (Output) It can have the following values: 

forum_error_table_$invalid_trans_idx 

There is no transaction corresponding to the supplied index. 

forum_error_table_$trans_deleted 

The deleted switch is set for this transaction and the caller is neither the chairman 
nor the author. 

forum_error_table_$trans_reaped 

The transaction has been physically removed from the meeting. 
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NOTES 

The forum_user_trans structure is declared in forum_user_trans.incl.pll and has the following 
structure: 



del 1 forum_user_trans 
2 type 
2 person_!d 
2 project_id 
2 time 
2 trans_no 
2 next_trans_ptr 
2 prev_trans_ptr 
2 subject_length 
2 text_length 
2 unf i 1 led 
2 subject 

2 text 



STRUCTURE ELEMENTS 



based (forum_user_trans_ptr) aligned, 

fixed bin, 

char (22) , 

char (9) , 

fixed bin(71) , 

fixed bin, 

ptr, 

ptr, 

fixed bin, 

fixed bin, 

bit(l) aligned, 

unaligned char (0 refer 

forum_user_trans.subject_length)) 

unaligned char (0 refer 

forum_user_trans.text_length)) ; 



type 

v-ui i c-ii 1.1 y , una uciu is uiiuacu. 

person_id 

is the Person_id of the author of this transaction. 

project_id 

is the Project_id of the author of this transaction. 

time 

is the clock reading of the time the transaction was entered. 

trans_no 

is the index of this transaction. 

next_trans_ptr 

is intended to be used to thread transactions together. It is set to null. 

prcv__ tXcuis p iT 

is intended to be used to thread transactions together. It is set to null. 

subjectjength 

is the length, in characters, of the subject of the transaction. 

text_length 

is the length, in characters, of the text of the transaction. 
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unfilled 

is set if the transaction should not be filled on output 

subject 

is the subject of the transaction. 

text 

is the text of the transaction. 



Entry: forum_$refuse_notifications 

This entry turns off reception of forum notifications by the calling process. 
USAGE 

declare forum_$refuse_notif ications entry (fixed bin(35)); 

call forum_$refuse_notif ications (status); 

ARGUMENTS 

status 

is a standard status code. (Output) It can have the following value: 

forum_error_table_$no_notify_seg 

The notifications database could not be initiated. 

Entry: forum Sreplace forum acl 

This entry replaces an entire access control list (ACL) for a meeting with a user-provided 
ACL, and can optionally add an entry for *.SysDaemon.* with mode rw to the new ACL 
This entry cannot be used on meetings created with pre-MRll software. 

USAGE 

declare forum_$replace_forum_acl entry (char (*) , char (*) , ptr, fixed bin, 
bit(l) , fixed bin(35)) ; 

call forum_$replace_forum_acl (dirname, entryname, acl_ptr, acl count, 
no_sysdaemon_sw, code) ; ~~ 

ARGUMENTS 

dirname 

is the pathname of the directory containing the meeting. (Input) 
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entryname 

is the entryname of the meeting. (Input) The ".forum" suffix is required. 

acl_ptr 

points to the user supplied segment_acl structure that is to replace the current ACL. 
(Input) The segment_acl structure is described in the forum_$set_forum_acl entry point 

acl_count 

is the number of entries in the segment_acl structure. (Input) 

no_sysdaemon_sw 

is a switch that indicates whether an rw *.SysDaemon.* entry is to be put on the ACL 
of the meeting after the existing ACL has been deleted and before the user-supplied 
segment_acl entries are added. 

(Input) 

"0"b adds rw *.SysDaemon.* entry 

"V'b replaces the existing ACL with only the user-supplied 
segment_acl 

code 

is a storage system status code. (Output) 

NOTES 

If acl_count is zero, then the existing ACL is deleted and only the action indicated (if any) 
by the no_sysdaemon_sw switch is performed. If acl_count is greater than zero, processing of 
the segment_acl entries is performed top to bottom, allowing later entries to overwrite 
previous ones if the access_name in the segment_acl structure is identical. 

Entry: forum_$set_delete_sw 

This entry is used to delete or retrieve a transaction. 

USAGE 

declare forum_$set_delete_sw entry (fixed bin, fixed bin, bit(l) aligned, 
fixed bin (35)); 

call forum_$set_delete_sw (forum_idx, trans_idx, delete_sw, status); 

ARGUMENTS 

forum_idx 

identifies a meeting opened by forum_$open_forum. (Input) 

trans_idx 

is the index of the transaction whose delete switch is to be changed, (Input) 
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delete_sw 

should be on to delete the transaction, or off to retrieve it 

status 

is a standard status code. (Output) It can have one of the following values: 

forum_error_table_$chairman_only 

The caller is neither the author of the transaction nor the chairman of the meeting. 

fOrum_error_table_$invalid_trans_idx 

There is no transaction corresponding to the supplied index. 

Entry: fbrum_$set_event channel 

This entry is used to set the event channel used to send wakeups when interesting forum 
events occur. 

USAGE 

declare forum $set_event_channel entry (char (*) , char (*) , fixed bin (71) , 
fixed bin (35)) ; 

call forum_$set_event_channel entry (dirname, entryname, event_channel , 
status) ; " 

ARGUMENTS 

dirname 

is the pathname of the directory containing the meeting (Input) 

entryname 
| is the name of the meeting. The ".forum" suffix is required. (Input) 

event_channel 

is the event channel which should receive wakeups from other users attending the same 
meeting. (Input) 

status 

is a standard status code. (Output) 

NOTES 

Currently, the only wakeup sent by Forum occurs when a transaction is entered while you are 
attending the meeting The message passed with this wakeup is: 

del 1 forum_message, 

2 uid bit (36) al igned, 

2 attendee_idx fixed bin; 
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STRUCTURE ELEMENTS 

uid 

is the unique identifier of the meeting. It should be passed to forum_$validate_uid to 
ensure that the user is still attending that meeting. 

attendee_idx 

identifies the user who entered the transaction. A character string containing the name of 
that user can be obtained by passing this to forum_$convert_attendee_idx. 

Entry: forum_$set__event_channel_idx 

This entry is used to set the event channel used to send wakeups when interesting forum 
events occur. 

USAGE 

declare forum_$set_event_channel_idx entry (fixed bin, fixed bi n (71) , 
fixed bin (35)) ; 

call forum_$set_event_channel_idx entry (forum_idx, event_channel , status); 

forum_idx 

identifies a meeting opened by forum_$open_forum. (Input) 

event_channel 

is the event channel which should receive wakeups from other users attending the same 
meeting. (Input) 

status 

is a standard status code. (Output) 

NOTES 

See the forum_$set_event_channel entry point for a description of interprocess messages used 
by Forum. 
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Entry: forum $set_forum acl 

This entry adds specified access modes to the access control list (ACL) of a meeting. If an 
access name already appears on the ACL of the segment, its mode is changed to the one 
specified by the call. This entry cannot be used on meetings created with pre-MRll 
software. 

USAGE 

declare forum_$set_forum_acl entry (char (*) , char (*) , ptr, fixed bin, fixed 
bin (35)); 

call forum_$set_forum_acl (dirname, entryname, acl_ptr, acl_count, code); 

ARGUMENTS 

dirname 

is the name of the directory containing the meeting. (Input) 

entryname 

is the name of the meeting. (Input) The meeting suffix is required. 

acl_ptr 

points to a user-filled segment_acl_array structure (see "Notes" below). (Input) 

acl_count 

contains the number of ACL entries in the segment_acl_array structure (see "Notes" 
below). (Input) 

code 

is a storage system status code. (Output) 

NOTES 

The segment_acl_array structure should be declared in the following way: 

del segment_acl_array (acl_count) aligned like segment_acl_entry; 

The segment_acl_entry structure (declared in the include file acl_structures.incl.pll) is as 
follows: 

del 1 segment_acl_entry aligned based, 

2 access_name char (32) unaligned, 

2 mode bit (36) aligned, 

2 extendedjnode bit (36) aligned, 

2 status code fixed bin (35); 
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STRUCTURE ELEMENTS 

access_name 

is the access name {in the form Person_id.Project_id.tag) that identifies the processes to 
which this ACL entry applies. 

mode 

contains the modes for this access name. This must be set to the constant RW_ACCESS 
declared in the include file access_mode_values.incl.pll. 

extended_mode 

is the extended access mode for this access mode. It must be set to one of the constants 
declared in forum_access_modes.incl.pll. 

status_code 

is a storage system status code for this ACL entry only. If code is returned as 
error_table_$argerr, then the erroneous ACL entries in the segment_acl structure have 
status_code set to an appropriate error code. No processing is performed. 

Entry: forum__$set message 

This entry is used to set a chairman's greeting message for a Forum meeting. 

USAGE 

declare forum_$set_message entry (fixed bin, char (*) , fixed bin (35)); 

cs I I f orunfi_^5sct__rn©ss3g© (forum idx* nrBssacrc ststius) * 

ARGUMENTS 

forum_idx 

identifies a meeting opened by forum_$open_forum. (Input) 

message 

is the text message, this can contain at most 256 characters. (Input) 

status 

is a standard status code. (Output) It can have one of the following values: 

forum_error_table_$chairman_only 

The caller is not the chairman of the meeting. 

forum_error_table_$message_too_long 

The message exceeds the 256 character limit 
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Entry: forum_$set seen switch 

This entry marks a transaction as having been seen by a participant This entry cannot be 
used on meetings created with pre-MRll software. 

USAGE 

declare forum_$set_seen_swi tch entry (fixed bin, char (*) , fixed bin, bit (i) 
aligned, fixed bin (35)); 

call forum_$set_seen_swi tch (forum_idx, person_id, trans_idx, value, status); 

ARGUMENTS 

forum_idx 

identifies a meeting opened by forum_$open_forum. (Input) 

person_id 

is the user name of the participant for whom the transaction is to be marked as seen. 
(Input) If this is blank, the person_id of the caller is assumed. Chairman access is 
required to change a seen switch for another participant. 

trans_idx 

is the number of the transaction to be marked. (Input) 

value 

is on if the transaction is to be marked as seen, and off otherwise. (Input) 

status 
j is a standard status code. (Output) 

Entry: forum $set switch 

This entry is used to change several switches associated with a Forum meeting or its 
participants. 

USAGE 

declare forum_$set_swi tch entry (char (*) , char (*) , char (*) , char (*) , bit(l) 
aligned, fixed bin (35)); 

call forum_$set_swi tch (dirname, entryname, person_id, swi tchjname, 
swi tch_sett i ng , status) ; 

ARGUMENTS 

dirname 

is the pathname of the directory containing the meeting. (Input) 
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entryname 

is the name of the meeting. The ".forum" suffix is required. (Input) 

person_id 

is the Person_id of the user on whose behalf you are setting the switch. The Projected 
should not be given. Starnames are not permitted. If this is blank, the current user is 
assumed. Only the chairman of a forum can set switches for persons other than herself. 
(Input) 

switchjiame 

is the name of the switch to set See "List of Switches" below. (Input) 

switch_setting 

is the new switch setting. (Input) 

status 

is a standard status code. It can have one of the following values: 

forum_error_table_$chairman_only 

Person_id does not identify the caller and the caller is not the chairman. 

forum_error_table_$invalid_switch_name 

The switch_name is not one of the valid switches. 

forum_error_table_$switch_not_changed 

The old setting was the same as the new setting. 

LIST OF SWITCHES 

adjourned, adj 

Prevents users from entering the meeting. Only the chairman can set this switch. 

meeting_eligibility_messages, mtg_emsg 

Turns on printing of eligibilty messages for this meeting. This switch can only be set by 
the chairman. 

notify, nt 

Turns on the notify switch for the meeting. This means that an interactive message will 
be sent each time a transaction is entered if the user is logged in and has issued the 
forum_accept_notifications command. 

participating, part 

Turns on the participation switch for the meeting. 

safety 

Changes the storage system safety switch for the meeting. The meeting cannot be deleted 
if this switch is on. 
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Entry: forum__$set_switch__idx 

This entry is used to change several switches associated with a Forum meeting or its 
participants. It is the same as the set_switch entry point except that a forum_idx is used to 
identify the meeting instead of a pathname. 

USAGE 

declare forum_$set_swi tch_idx entry (fixed bin, char (*) , char (*) , 
bit(l) aligned, fixed bin (35) ) ; 

call forum_$set_switch_idx (forum_idx, person_id, switch name, switch setting, 
status) ; 

ARGUMENTS 

forum_idx 

identifies a meeting opened by forum_$open_forum. (Input) 

person_id 

is the Person_id of the user on whose behalf you are setting the switch. The Projected 
should not be given. Surnames are not permitted. If this is blank, the current user is 
assumed. Only the chairman of a forum can set switches for persons other than herself 
(Input) 

switch_name 

is the name of the switch to set. See "List of Switches" below. (Input) 

switch_setting 

is the new switch setting. (Input) 

status 

is a standard status code. It can have one of the following values: 

forum_error_table_$chairman_only 

Person_id does not identify the caller and the caller is not the chairman. 

forum_error_table_$invalid_switch_name 

The switch_name is not one of the valid switches. 

forum_error_table_$switch_not_changed 

The old setting was the same as the new setting. 

LIST OF SWITCHES 

access_changed 

Specifies that the ACL on the meeting has changed. This switch is set by the 
forum_chairman_$set_forum_acl entry point, and should normally only be turned off by 
this subroutine. 
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adjourned, adj 

Prevents users from entering the meeting. Only the chairman can set this switch. 

deleted 

Specifies that the attendee record for this user should be marked as deleted. 

meeting_eligibility_messages, mtg_emsg 

Turns on printing of eligibilty messages for this meeting. This switch can only be set by 
the chairman. 

message_seen 

Specifies that the chairman message on the meeting has changed. This switch is set by 
the forum_$set_message entry point, and should normally only be turned off by this 
subroutine. 

notify, nt 

Turns on the notify switch for the meeting. This means that an interactive message will 
be sent each time a transaction is entered if the user is logged in and has issued the 
forum_accept_notifications command. 

participating, part 

Turns on the participation switch for the meeting. 

safety 

Changes the storage system safety switch for the meeting. The meeting cannot be deleted 
if this switch is on. 

Entry: forum_$trans_ref_info 

This entry is used to obtain information about an individual transaction. This entry is 
obsolete. The forum_$real_trans_ref_info entry should be used instead. 

USAGE 

declare forum_$trans_ref_info entry (fixed bin, fixed bin, fixed bin, 
fixed bin, bit(l) aligned, fixed bin(35)); 

call forum_$trans_ref_info (forum_idx, trans_idx, prev_ref, next_ref, 
deleted_sw, status); 

ARGUMENTS 

forum_idx 

identifies a meeting opened by forum_$open_forum. (Input) 

trans_idx 

is the index of the transaction for which information is desired. (Input) 
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prev_ref 

is the index of the preceding transaction in the same transaction chain. This is zero if 
the transaction is the first in a chain. (Output) 

next_ref 

is the index of the next transaction in the same transaction chain. This is zero if the 
transaction is the last in a chain. (Output) 

deleted_sw 

is set if the transaction has been marked as deleted. (Output) 

status 

is a standard status code. (Output) It can have one of the following values: 

forum_error_table_$invalid_trans_idx 

There is no transaction corresponding to the supplied index. 

forum_error_table_$trans_reaped 

The transaction has been physically removed from the meeting. 

Entry: forum__$trans__time info 

This entry returns the indexes of transactions entered during a given time span. 

USAGE 

declare forum_$trans^_time_info entry (fixed bin, fixed b i h (71) > fixed b i n (71) * 
fixed bin, fixed bin, fixed bin (35)); 

call forum_$trans_time_info (forum_idx, low_time, high_time, low_trans, 
high_trans, status) ; 

ARGUMENTS 

forum_idx 

identifies a meeting opened by forum_$open_forum. (Input) 

low_time 

is the timestamp of the low end of the time span. (Input) 

high_time 

is the timestamp of the high end of the time span. (Input) 

low_trans 

is the index of the first transaction entered after low_time. If there are no transactions 
that new, than the index of the highest transaction in the meeting is returned. (Output) 
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high_trans 

is the index of the transaction entered immediately before high_time. If no transactions 
were entered before then, zero is returned. (Output) 

status 

is a standard status code. (Output). 

Entry: forum_$validate__uid 

This entry is used to determine if a given meeting unique identifier (uid) corresponds to a 
given meeting. 

USAGE 

declare forum_$val idate_uid entry (fixed bin, bi t (36) aligned, fixed bin(35)); 

call forum_$val idatejjid (forum_idx, forum_uid, status); 

ARGUMENTS 

forum_idx 

identifies a meeting opened by forum_$open_forum. (Input) 

forum_uid 

is the uid of the meeting. Normally this is obtained from Forum interprocess messages. 
(Input) 

status 

is a standard status code. (Output) It can have the following value: 

forum_error_table_$incorrect_uid 

The supplied uid is not the unique identifier of the meeting identified by forum_idx. 
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Name: forum_admin 

The forum_admin_ subroutine provides a site administrative interface to the Forum Interactive 
Meeting System. 

Entry: foram__admin $change_.chairman 

This entry is used to change the chairman of a Forum meeting by a system administrator 
who is not the current chairman of the meeting. 

USAGE 

declare forum admin $change_chai rman entry (char (*) . char (*) . char (ft) . 
fixed bin(35)f; 

call forum_admin_$change_chairman (dirname, entryname, chairman, status); 

ARGUMENTS 

dirname 

is the pathname of the directory containing the meeting. (Input) 

entryname 

is the entryname of the meeting. (Input) The ".forum" suffix is required. 

chairman 

is the name of the new chairman of the meeting, in the form Person_id.Project_id. The 
new chairman must already be a participant. (Input) 

status 

is a standard status code. (Output) It can have one of the following values: 

forum_error_table_$no_ r such_user 

The supplied new chairman is not a participant 

ACCESS REQUIRED 

The caller must have modify permission on the containing directory. 

Entry: forum_admin__$convert 

This entry is used to convert a meeting created with pre-MRll software into a current 
version meeting without requiring the user to be the chairman. 

USAGE 

declare forum_admin_$convert entry (char (*) , char (*) , fixed bin (355); 

call forum_admin_$convert (dirname, entryname, status); 
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ARGUMENTS 



dirname 

is the name of the directory containing the meeting. (Input) 

entryname 

is the name of the meeting. (Input) The ".forum" suffix is required. 

status 

is a standard status code. 

ACCESS REQUIRED 

The caller must have modify permission on the containing directory. 

Entry: forum_admin $delete_forum 

This entry is used to delete a meeting by a system administrator who is not the current 
chairman of the meeting. 

USAGE 

declare forum_admi n_$de1ete_forum entry (char (*) , char (*) , fixed bin (35)); 

call forum_admin_$delete_forum (dirname, entryname, status); 

ARGUMENTS 

dirname 

is the pathname of the directory containing the meeting. (Input) 

entryname 

is the entryname of the meeting. The ".forum" suffix is required. (Input) 

status 

is a standard status code. (Output) 

ACCESS REQUIRED 

The caller must have modify permission on the containing directory. 
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Entry: foruin_adinm_$iiiit notifications 

This entry is used to create the notifications database. 

USAGE 

declare forum_admin_$init_notif ications entry (fixed bin(35)); 

call forum_admin_$ini t_not if ications (status); 

ARGUMENTS 

status 

is a standard status code. (Output) 

ACCESS REQUIRED 

The caller must have "sma" access to the central forum directory. 

Entry: forum_admin_$set_forum acl 

This entry is used to add or change an ACL term on a meeting. ACL terms can only be 
specified for Person_id.* or *.Project_id, terms of the form Person_id.Project_id are not 
allowed. The caller need not be the chairman of the meeting. 

USAGE 

declare forum_admin_$set_forun!_acl entry (char (*) , char (*) , char {*) , bit{l) 
aligned, bit(l) aligned, bit(l) aligned, fixed bin(35)); 

call forum_admin_$set_forum_acl (dirname, entryname, access_name, user_sw, 
set_sw, write_sw, status); 

ARGUMENTS 

dirname 

is the pathname of the directory containing the meeting. (Input) 

entryname 
j is the entryname of the meeting. The ".forum" suffix is required. (Input) 

access_name 

is the Personjd or Project_id whose ACL is to be added or deleted. Access_name can 
not contain a ".". (Input) 

user_sw 

This switch should be on if access_name is a Personjd, and off if it is a Project id 
(Input) 
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set_sw 

This switch should be on if access is to be added, and off if it is to be deleted. (Input) 

write_sw 

This switch should on if write access is to be added, and off if only read access is to 
be added. This switch is ignored if set_sw is off. (Input) 

status 

is a standard status code. (Output) 

ACCESS REQUIRED 

The caller must have modify permission on the containing directory. 

Entry: forum_,admin_$set_global_switch 

This entry is used to set switches associated with the forum environment for an entire site. 
USAGE 

declare forum admin_$set_global_swi tch entry (char (*) , bit(l) aligned, fixed 
bin (35)7; 

call forum_admin_$set_global_swi tch (swi tch_name, value, status); 

ARGUMENTS 

switch_name 

is the name of the switch to be set It can be one of "print_eligiblity_messages", 
"pemsg", "chairman_set_eligibilty_msg", or "cm_set_emsg". (Input) 

value 

is the value to be assigned to the switch. (Input) 

status 

is a standard status code. (Output) It can have the following value: 

forum_error_table_$invalid_switch_name 

The switch_name given was not one of those listed above. 

ACCESS REQUIRED 

The user must have "rw" access to forum data . 
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iiiiiry. mimu auiuui Saci swilCii 

This entry is used to change several switches associated with a Forum meeting or its 
participants. The caller need not be the chairman of the meeting in order to set any of the 
switches. 

USAGE 

declare forum_admin_$set_swi tch entry (char (*) , char (*) , char (*) , char (*) , 
bit(l) aligned, f ixed bin (35)) ; 

call forum_admin_$set_switch (dirname, entryname, person_id, swi tch_name, 
switch_setting, status); 

ARGUMENTS 

dirname 

is the pathname of the directory containing the meeting (Input) 

entryname 

is the name of the meeting The ".forum" suffix is required. (Input) 

person_id 

is the Person_id of the user on whose behalf you are setting the switch. The Project_id 
should not be given. Starnames are not permitted. If this is blank, the caller's Person_id 
is used. (Input) 

switch_name 

is the name of the switch to set. See "List of Switches" below. (Input) 

switch_setting 

is the new switch setting. (Input) 

status 

is a standard status code. It can have one of the following values: 

forum_error_table_$invalid_switch_name 

the switch_name is not one of the valid switches. 

forum_error_table_$switch_not_changed 

the old setting was the same as the new setting. 
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UST OF SW/TCHES 

access_changed 

Specifies that the ACL on the meeting has changed. This switch is set by the 

forum_chairman_$set_forum_acl entrypoint, and should normally only be turned off bv 

this subroutine. J 

adjourned, adj 

Prevents users from entering the meeting. 

deleted 

Specifies that the attendee record for this user should be marked as deleted. 

meeting_eligibility_messages, mtg_emsg 

Turns on printing of eligibilty messages for this meeting. 

message_seen 

Specifies that the chairman message on the meeting has changed. This switch is set by 

the forum_$set_message entrypoint, and should normally only be turned off by this 
subroutine. * 

notify, nt 

Turns on the notify switch for the meeting. This means that an interactive message will 

be sent each time a transaction is entered if the us*r « w<»>rf *« ->~* w ; a <.*.. 

(._,„ „_.„_* _ «.•<•• .. . _ " — ~ ™ ^ggcu in aim nas issued mc 

iorum_accept_notifications command. 

participating, part 

Turns on the participation switch for the meeting. 

The caller must have either modify permission on the containing directory or write access to 
tne .forum segment 
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Like every system, Forum has some terms that have special meaning. This section will 
attempt to make some of them clear. 

attending, attendee 

A user is attending a meeting if he or she is currently using the Forum system 
and has entered that meeting (using the forum "goto" request). Attending is 
analogous to being inside the room where the meeting is being held as 
opposed to participating, which is like having been there and gone out' for 
coffee. 

chairman 

The chairman of a meeting is the user who controls the activities in the 
meeting. Usually it is the user who created or convened the meeting in the 
first place, but since the chairmanship can be passed on to another user, this is 
not always the case. It is the chairman who can adjourn meetings and controls 
such things as who is eligible to participate in the meeting. He can also delete 
and retrieve transactions. 

control arguments 

Forum commands and requests all perform a specific function, and most have 
special options that modify the default action or tell Forum exactly which 
transactions or meetings to operate on. Control arguments always start with the 
- character. 

current meeting 

The current meeting is the one you are currently attending and remains so 
until you explicitly attend a different meeting (using the "goto" request) or exit 
Forum (using the "quit" request). 

current transaction 

The current transaction is the one that the user has just listed printed 
entered, or otherwise referred to. Since Forum keeps track of the current 
transaction, it performs requests that are issued with no transaction specifier on 
the current transaction (this is the default). 

eligible 

A user is eligible to participate in a meeting if the chairman of the meeting 
has set the access on the meeting in such a way as to allow that user to 
participate in the meeting. A user must be eligible to participate before he or 
she can attend. 
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flag 

Flags are printed when you list either meetings or participants in a meeting. 
Flags consist of one letter and indicate the user's state with respect to that 
meeting (e.g., "a" means that you are currently attending that meeting, "e" 
means eligible to participate and "p" means you are already a participant). 

Forum 

Forum is the system itself and the programs or software that comprise it 
Forum enables eligible users to create, enter, participate in, and manage 
meetings. 

forum 

When you type "forum" at command level, you are typing the forum 
command, which enters you into the Forum subsystem (see also Forum). 

keyword 

A keyword is a transaction specifier consisting of a generic term that describes 
one or more transactions (e.g., "first" and "all"). 

meeting 

A meeting consists of a chairman, a list of participants, and the proceedings or 
minutes. Meetings are Forum's reason for existence. There will likely be many 
meetings on a system, each created to discuss some specific or general topic or 
issue. Each meeting is identified by a long, descriptive name (such as 
Everybody's_Meeting), and at least one short, easy-to-use name (such as eve). 

participate, participant 

A user is considered to be participating in a meeting if he or she has entered 
that meeting at least once. The first time a user goes to a meeting, a record 
of that user's participation in that meeting is created, making the user an 
official participant 

proceedings 

The proceedings of a meeting are the record maintained by Forum of what 
exactly has been said during the life of the meeting, and by whom. This 
record of what took place can be examined in a flexible fashion by 
participants of the meeting. 

regular expression 

Regular expressions are transaction specifiers used with Forum requests. They 
consist of character strings (letters, numbers, words, or phrases) enclosed in 
slashes (/) to be matched against the text of transactions. Certain special 
characters can be used for fancier matching techniques. See Section 4. 
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request 

A request is how a participant tells Forum to perform some action, such as 
entering a meeting, printing out transactions, or finding out the names of the 
other participants in a meeting. Forum requests are very similar in syntax to 
Multics commands. 

request line 

A request line is a Forum request, optionally followed by arguments, control 
arguments, and transaction specifiers. 

request loop 

The request loop is the part of Forum that reads the request you type, 
performs the specified operation, and finishes with a prompt to you (forum:) 
for another request This is a repeating cycle until you exit Forum. 

search list 

The forum search list is a list of pathnames of directories that contain 
meetings which you want to attend. It is manipulated via the add_search_paths 
and delete_search_paths commands, and printed with the print_search_paths 
command (all described in the Commands manual). 

search path 

A search path is a pathname of a directory in your search list. 

transaction 

A transaction is a statement made by an attendee in a meeting. Entering a 
transaction is Forum's equivalent of speaking at a real meeting. The text of 
the transaction, its subject, the date and time it was entered, and the name of 
the participant who entered it are placed in the proceedings of a meeting. 
Other participants can then use Forum requests to manipulate the transactions 
of the meeting, such as "print" and "list" to look at the transaction. 

transaction chain 

A transaction chain is a series of transactions that are related in that they all 
refer to one previous transaction. In other words, it is a discussion centered 
on the transaction of one user, linked together by a common subject (see 
"Transaction Chains" above). 

transaction specifier 

A transaction specifier is a way of choosing a transaction or a group of 
transactions for Forum to list, print, write, or otherwise refer to. Transaction 
specifiers come in many forms: transaction numbers, keywords, control 
arguments, and regular expressions. 

unprocessed transaction 

An unprocessed transaction is a transaction whose text you have prepared either 
in response to another transaction, or to start a new discussion in a meeting, 
but have not yet entered it into the proceedings of the meeting. It can be 
manipulated in a number of ways (see Section 4). 
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INDEX 



MISCELLANEOUS 



. (current) request k~7 , 5~3, 
7-3 

. .COMMANDJJNE escape 5-2, 
6-2, 7-3 

? request 2-2, 5-1 
see also help 



abb rev (ab) request 6~6» 7~4 

abbreviations 6 - 5 
abbrev request 6~6 

active requests 3 _ 6. 6"1 

add_meeting (am) request 7-5 

add_participant (apt) request 
7-7 

add_project (apj) request 7-7 

administrative information 
A-l 
forum_admin command A-i» 



advanced requests 6 _ 1 

allref (aref) keyword 3~1» 

announcement_info (ai) request 
7-9 

announcejneeting (am) request 
7-8 

answer request 7~10 

apply (ap) request Ij-6, 7 - 12 

attendee C-l 
record 9"5 



central forum directory 2-2 

chain-tracing keywords 3-4 
as active requests 3"6 
as requests 3"6 

chairman C-l 
changing A-l 

chairman (cm) request 2-5, 
7-H 
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chairman's commands 
convert_forum 10-9 
forum_add_participant (fapt) 

10-2 
forum_add_project (fapj) 

10-3 
forum_create (fcr) 10-1* 
forum_delete (fdl) 8" 12 
forum_make_publ ic (fmp) 

command 10-5 
f orum_remove_par t i c i pant 

(frpt) command 10-6 
forum_remove_project (frpj) 

10-7 
forum_unmake_publ ic (fump) 

10-8 

chairman y s duties 

creating a meeting 9"1 
deleting a meeting 9"H 
maintaining a meeting 9~2 
adding a participant 9~3 
adding a project S~k 
deleting transactions 9~7 
making a meeting private 

9-4 
making a meeting public 

9-4 
pr inting el igibi 1 i ty 

messages 9"9 
removing a participant 

9-5 
removing a project 9"6 
retrieving participants 

and transactions 9"8 
setting a message 9"9 

chairman's message k~l 
setting 9-9 

chairman_message (cmsg) 
keyword 3"6 

character string matching 
regular expressions 3"8 

check_meetings (ckm) request 
7-15 



command processor escape 5"2, 
6-2, 7-3 

commands 

administrative A-l» 
chairman commands 10-1 
user commands 8 - l 

conditional execution 
if request 6~3 

control arguments C-l 
and requests 6 - l 
as transaction specifiers 
3-6 

convert_forum 10-9 

creating a meeting 9"! 

specifying participants 9 - 2 

current (.) request 4 - 7» 5~3» 
7-3 

current meeting C-l 

current transaction 3"3, C-l 

current_meeti ng (cmtg) request 
7-16 



date and time control 
arguments 3"7 

delete (dl) request kS, 7"16» 
9-7 

delete_participant (dipt) 
request 7"18, 9~5 

deleting a meeting 9- 11 

do request 7"18 
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editors 
emacs k~G 
qedx 1»~3 
ted 4-3 

eligibility message 2-5, A~3 

eligible C-l 

enter (en s send) request 7"20 

execute (e) request 6 - 3, 7 _ 22 

exec_com (ec) request 6 _ 6, 
7-21 

exec_coms 6 - 6 
start_up.ec 6 _ 8 
start_up.fmec 6~7 

exi ti ng forum 2-7 

expunge request 7 _ 22, 9~5. 
9-8 



fant 

see forum_accept_notifi cations 



fapj 

see forum_add_project 

fapt 

see forum_add_participant 

fcr 

see forum create 



fd 



see forum dir 



fdl 

see forum_deiete 

fill (fi) request k~B, 7"23 

firstref (fref) keyword 3"4 

flags 2-2, 7-34, 8-17, 8-20, 
C-2 
notify 3-12 

flsm 

see forum_l ist_meetings 

flsu 

see forum_l ist_users 

fmp 

see forum_make_publ ic 

formatting saved transactions 
3-3 

Forum 1-1, C-2 
abbreviations 6~5 
advanced requests 6~1 
benefits and typical uses 

1-1 
central directory 2-2 
control arguments 6"4 
entering 2-1 
exee_coms 6^6 
exiting 2-7 
getting help 2-2 
on-1 ine help 5"! 
prompt 6~5 
request loop 2-1 
search list 2-3 
search paths 2-2 
start_up 6~7 
version number 5"3 

forum command 6 - 4, 8~2, C-2 
control arguments 6 _ 4 

Forum instal lation 

instructions A-l 

forum subroutine B-2 
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f orum_$accept_not i f i cat ? ons 
B-2 

forum_$change_chairman B-2 

f orum_$change_cha i rman_i dx 
B-3 

forum_$check_user B-8 

forum_$chname_forum B-i» 

forum_$chname__forum_idx B~5 

forum_$dose_forum B~9 

forum_$convert B-9 

for um__$conver t_attendee_i dx 
B-10 

forum_$create_forum B-6 

forum_$deiete_forum B-10 

forum_$delete_forum_acl B-ll 

forum_$enter_trans B- 12 

forum_$expunge B- 13 

forum_$forum_i nfo_idx B-16 

forum_$f orum_] imi ts B- 1 7 

forum_$get_forum_path B- 18 

forum $get_forum_path_idx 
B-19 

forum_$get_message B-20 

forum_$get_transaction_map 
B-21 

forum_$get_uid w f i le B-22 

forum_$info B- 13 



forum_$l ist_forum_acl B-23 

f orum_$ 1 i st_users B-2I» 

forum_$l ist_users_Jdx B-26 

forum_$l i st_vl_forum_acl B-21* 

forum_$open_forum B-27 

forum_$read_trans B-28 

f orum_$ref use_not i f i cat i ons 
B-30 

forum_$replace_forum_acl B-30 

forum_$set_delete_sw B-31 

forum_$set_event_channel B-32 

forum_$set_event channel idx 
B-33 

forum_$set_forum_acl B-$k 

forum_$set_message B-35 

forum_$set_seen_swi tch B-36 

forum_$set_swi tch B-36 

forum_$set_swi tch_idx B~38 

forum_$set_vl_forum_acl B-6 

forum_$trans_ref_info B~39 

forum_$trans_time_info B-l»0 

forum_$vl_expunge B-7 

forum_$val idate_uid B-i»l 

f orum_accept_not i f i cat i ons 
(fant) command 3" 12, 
8-10 
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forum_add_meeting (fam) 
request 8 _ 11 

f or um_add_par t i c i pant (f apt) 
command 9"3» 10-2 

forum_add_project (fapj) 
command S~k, 10-3 

forum_admin command k-k 

forum_admin_ subroutine B-42 

f orum_adm i n_$change_cha i rman 
B-I»2 

forum_admin_$convert B-42 

f orum_admi n_$del ete_f orum 
B-U3 

f orum_admi n_$ i n i t_not i f i cat i ons 
ions B-44 

f or um_adm i n_$ s e t_f o r um_a c ] 
B-kk 

f or um_adm i n_$ set_g 1 oba 1 _sw i tch 
B-i»5 

forum_admin_$set_switch B-46 

forum create (fcr) command 
9-1, 10-4 

forum_delete (fdl) command 
8-12, 9-11 

forum_dir (fd) command 2-2, 
8-13 



forum_make_publ ic (fmp) 
command 3-4, 10-5 

f orum_ref use_not i f i cat i ons 
(frnt) command 3"13» 
8-21 

forum_remove_meeting request 
8-22 

f orum_r emove_par t i c i pant 

(frpt) command 9"5» 10-6 

forum_remove_project (frpj) 
command 9"6, 10-7 

forum_unmake_publ ic (fump) 
command 9~4» 10-8 

frnt 
see 
forum refuse notifications 



frpj 

see forum_remove_project 

frpt 

see forum_remove_participant 

fump 

see f orum_unmake_pub 1 i c 



gates A-2 
glossary C-l 



forum_dir (fd) request 7-21* goto (go, g) request 2-5, 



forum_l ist_meetings (flsm) 
command 8 - 14 

f orum_l i st_users (f 1 su) 
command 8~18 
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greeting message 

chai rman_message 3 _ 6 
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help 2-2, 5-i 
? request 5 - l 
help request 5-3 
list_help (lh) request 5-2 
1 ist_requests (lr) request 
5-2 

help request 5-3, 7-25 



if request 6~3. 7~2? 

installation instructions 
AIM A-3 

central forum directory A-l 
gate access A-2 
notifications database A-2 

interrupting lengthy output 
3-13 



keywords 3~2, C-2 

al 1, a 3"*t 

as active requests 3-6 

as requests 3 - 6 

as transaction specifiers 
3-1* 

chain-tracing 3-l» 
allref, aref 3—1* 
firstref, fref 3-4 
lastref, lref 3-4 
nextref, nref 3"5 
priorref, pref 3-5 
restref, rref 3-5 

chai rmanjnessage 3~6 

current, c 3 - 4 

first, f 3-4 

highest, last_seen 3-4 

last, 1 3-l» 



keywords (cont) 
new 3-4 
next, n 3-4 
previous, p 3 - l» 
unprocessed, u 3-4 



lastref (lref) keyword 3-4 

list (Is) request 3-1, 7-28 

list_help (lh) request 5-2, 
7-31 
see a iso help 

1 ist_meetings (Ism) request 
2-1, 7-31 

1 ist_requests (lr) request 
5-2, 7-31* 
see also help 

list_users (lsu) request 2-5, 
6-1, 7-35 

locating meetings 
search paths 2-2 



M 



mail request 7 - 38 

maintaining a meeting 9-2 
adding a participant 9"3 
adding a project 9-4 
deleting transactions 9-7 
making a meeting private 

3-k 
making a meeting public S~k 
printing el igibi 1 i ty 

messages 9"9 
removing a participant 9"5 
removing a project 9~6 
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maintaining a meeting (cont) 
retrieving participants and 

transactions 9~8 
setting a message 9-9 

mak e_pub lie r eques t 7-39 

meetings 1-2, C-2 

attending 2-k 

chairman 2-5 

current C-l 

eligibility message 2-5 

el igible participants 2-6 

flags 2-2 

listing 2-1 

locating 2-2 

moving A-l 

participants 2-5 

private 2-3 

speaking 1»-1 

reply (r) request k-2 
talk (t) request 4-1 

Multics command processor 
escape 5-2, 6-2, 7~3 



nextref (nref) keyword 3-5 

next_meeting (nm) request 
7-W 

not i f i cat ions 
cancelling 3-13 
receiving 3-12 

notifications database 
creating A-l, A-2 

notify switch 3- 12 

numbers 

as transaction specifiers 
3-3 



on-1 ine help 5-1 

output 

interrupting 3-13 



participant 
expunging 9-5 

participants C-2 
el igibie 2-6 
listing 2-5 
private meetings 2-6 
removing 9-5 
retrieving 9 - 8 

personalizing your Forum 
envi ronment 
abbreviations 6~6 
exec_coms 6 - b 

forum control arguments 6 - 4 
forum start_up 6~7 

Person_ids 

as transaction specifiers 
3-7 

print (p) request 4-8 

print (pr, p) request 3-2, 
7-41 

printing transactions kS 

priorref (pref) keyword 3-5 

private meetings 2-3, 2-6 
forum_unmake_publ ic command 
9-4 

proceedings C-2 
listing 3-1 
printing 3-2 



1-7 



CY7i|-02 



proceedings (cont) 
saving 3"2 

prompt 

setting S~5 

pub I ic meetings 

central forum directory 2-2 
el igibi 1 ity message 2-5 
forum_make public command 
9-i. 



qedx 

request 7~43 

qedx (qx) request 4-3 

simple editor requests 4~4 

qedx regular expression C-2 

qedx regular expressions 3-8 

quit (q) request 2-7, 7"44 



ranges of transactions 3-3 

regular expression C-2 

regular expressions 3~8 
matching subject 3-8 
matching text 3-8 
special characters 3-9 

remove meeting (rm) request 
7-ifi* 

remove_participant (rpt) 
request 7"45 

remove_project (rpj) request 
7~46 



reply (rp) request 1,-2, 7"46 

request 1 ine C~3 
abbreviations 6~6 

request loop 2-1, C-3 

requests C~3 
. (current) 7-3 
. .command_l ine 7"3 
? 5-1 

abbrev 6 _ 6, 7~4 
add_meeting 7 "5 
add_participant 7-7 
add_project 7~7 
announcement_info 7-9 
announce_meet i ng 7 - 8 
answer 7~ 10 
apply 4-6, 7-12 
chairman 7" 14 
check_meetings 7 - 15 
current_meeting 7-16 
delete 1,-9, 7-I6 
delete_participant 7- 18 
do 7-18 
enter 7-20 
execute 7-22 
exec_com 6~6, 7-21 
expunge 7~22 
fill 1,-8, 7-23 
forum_add_meet?ng 8~11 
forum_dir 7-21, 
forum_remove_meeting 8-22 
goto 7-21, 
help 5-3, 7-25 
if 6-3. 7-27 
list 7-28 

listjielp 5-2, 7-31 
1 istjneetings 7-3 1 
1 ist_requests 5~2, 7~31» 
list_users 7~35 
mail 7-38 
make_public 7 "39 
next_meeting 7"40 
print 1,-8, 7~41 
qedx 4-3, 7-1,3 
quit 7-44 
remove_meeting 7 - 44 
remove_participant 7~45 
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requests (cont) 

remove_project 7 - 46 
reply 4-2, 7"46 
reset 7~48 
retrieve if— 9 > 7 _ 49 
retrieve_participant 7~50 
send 7-20 

set_message 7~51» 9 - 9 
subject 4-9, 7-52 
subsystem_name 7"53 
subsystem_version 7"54 
switch_off 7-54 
switch_on 7~55 
talk 4-1, 7-56 
ted 4-3, 7-58 
unmake_publ ic 7~59 
write 7"60 

reset (r) request 7 - 48 

restref (rref) keyword 3-5 

retrieve (rt) request 4-9, 
7-49, 9-8 

retr ieve_participant (rtpt) 
request 7 - 50, 9~8 



start_up.ec 6~8 

accepting notifications 

3-13 
search paths 2-4 

start_up.fmec 6 _ 7 

subject (sj) request 4~9, 
7-52 

subroutine descriptions 
forum_ B-2 
forum_admin_ B-42 

subsystem_name request 7 - 53 

subsystem_version request 
7-54 

switches 2-2 
notify 3-12 

switch_off (swf) request 3-13, 

l-Sk, 9-10 



7-55, 9-10 



3 „. ,a.f 4- 1.11 

^%bB K4 Wi ^ 1* ) £ « £ 



search 1 ist C~3 

search paths 2-2, 2-3, C~3 
in your start_up.ec 2-4 
printing 2-3 
setting 2~3 

send (enter, en) request 7-20 

setjnessage request 7 _ 51, 9 - 9 

sorting by chain 3"8 

speak i ng 

reply (rp) request 4~2 
talk (t) request 4-1 



talk (t) request 4-1, 7-56 

ted request 4-3, 7 - 58 

text editors 
emacs 4 _ 6 
qedx 4 _ 3 
ted k~l 

transaction 1-2 
chain 1-3 
current C-l 
initial 1-2 

transaction chain 1-3, 4-3, 
C-3 
keywords 3 _ 4 
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transaction chain (cont) 
sorting by 3~8 

transaction numbers 3-3 

transaction specifiers 3~1» 
3-3, C-3 
by date and time 3-7 
by subject 3-8 
by text 3-8 

chairman_message (cmsg) 3~6 
control arguments 3"6 
examples 3~9 
keywords i~k 

chain-tracing 3"J» 
numbers 3"3 
Person_ids 3 - 7 
ranges of numbers 3~3 
regular expressions 3"8 
simple operators 3~3 
sorting by chain 3 - 8 

transactions C-3 
current 3~3 
deleting kS, 9"7 
ed i t i ng 

emacs 4-6 

qedx l»-3 

ted 4-3 
expunging 9~8 
filling k~B 
1 i sting 3 _ 1 
new 3-11 

receiving notification 
3-12 
pre-written 4-6 
printing 3~2, k~8 
ranges of 3~3 
retrieving kS, 9 - 8 
saving 3 _ 2 

delimiters 3 - 3 

formatted output 3~3 

naming the segment 3 - 2 
unprocessed k~5 



unmake_publ ic (ump) request 
7-59 

unprocessed transaction 5~k, 
k~5, C-3 

users ' commands 
forum 8 - 2 
f orum_accept_not i f i cat i ons 

(fant) 8-10 
forum_dir (fd) 8~13 
forum_l ist_meetings (flsm) 

8-U 
forum_l ist_users (flsu) 

8-18 
f or um_ref use_not i f i cat i ons 
(frnt) 8-21 



version number 5~3 



write (w) request 3~2, 7~60 
del imi ters 3"3 
formatted output 3~3 
naming the segment 3~2 
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